# dolphinlog
<img src="https://github.com/xaratustrah/dolphinlog/raw/main/rsrc/dolphin.png" width=“128”>
_This program has been renamed to **`dolphinlog`** in order to avoid naming conflict with another software. But as you can see, the logo still shows the original animal as icon!_
`dolphinlog` is a program for amateur radio [(HAM)](https://en.wikipedia.org/wiki/Amateur_radio) operators for their daily use. There are tons of HAM log programs out there. This is yet another one, aiming to be free, modern but as well ultra simple by using only the command line interface in order to store QSO data in a SQLite database. An export function to ADIF-3 \*.adi is also available.
There are no editors, this means that the database file should be viewed using standard viewer programs, of which also many exist. Some examples are standalone programs such as [sqlitebrowser](https://github.com/sqlitebrowser/sqlitebrowser) or browser plugins such as [this one](https://addons.mozilla.org/en-US/firefox/addon/sqlite-manager/). This leaves the HAM a great deal of freedom to import, export in/to any format and manage the database. The typical usage of such a log program is for running on an ideally small or embedded computer such as [RaspberryPi2](https://en.wikipedia.org/wiki/Raspberry_Pi), as a HAM computer, where possibly also other HAM related software such as [fldigi](https://sourceforge.net/projects/fldigi/) are running, or HAM related hardware attached, such as [dongles](http://www.funcubedongle.com/) are also running. The name of this program is inspired by other HAM radio logger software available on the internet that have an animal name
in their title.
#### Installation
`dolphinlog` is by nature platform independent. The simplest way to install it is to use PyPI:
pip install dolphinlog
Other than that `dolphinlog` needs just a working Python 3 installation. So whatever OS you have, just put the script
somewhere you can call it, e.g. by symbolic linking like this:
ln -s dolphinlog /usr/local/bin/dolphinlog
#### Usage
Just type:
dolphinlog
In the command line and the program starts. If you like to skip an entry, just press enter. If no command line arguments are given at invocation time, then the program creates a folder in the home directory:
~/.dolphinlog/dolphinlog.sqlite
otherwise a specific database filename can be given by the `-db` switch. `-v` switch increases the verbosity. If the switch `-adi` is provided, then an `*.adi` file is exported. For this export either the default database file name is used, or a database filename should be given.
#### DB Fields and ADIF-3 export
`dolphinlog` supports export to function to the ADIF3 \*.adi format. The [ADIF 3](http://adif.org/) standard has a very comprehensive list of fields. In order to find a minimalistic implementation of export function, `dolphinlog` adapts the minimum ADIF record fields required by the website [eQSL](https://www.eqsl.cc), but also includes additional fields. Minimum ADIF-3 fields required by eQSL:
|Field | Description|
|-------|-------------|
|QSO_DATE| date on which the QSO started YYYYMMDD|
|TIME_ON| QSO time in UTC|
|CALL| the contacted station's Callsign|
|MODE| QSO Mode|
|BAND| QSO Band|
ADIF-3 fields fields recommended by eQSL:
|Field | Description|
|-------|-------------|
|FREQ| QSO frequency in Megahertz|
|PROP_MODE| QSO propagation mode|
|PROGRAMID| identifies the name of the logger, converter, or utility that created or processed this ADIF file|
|QSLMEG| QSL card message|
|RST_SENT| signal report sent to the contacted station|
ADIF-3 fields additionally used by `dolphinlog`:
|Field | Description|
|-------|-------------|
| NAME | the contacted station's operator's name |
| RST_RCVD | signal report from the contacted station|
|RX_PWR | the contacted station's transmitter power in watts|
|TX_PWR | the logging station's power in watts|
|GRIDSQUARE | the contacted station's 2-character, 4-character, 6-character, or 8-character Maidenhead Grid Square|
|NOTES | QSO Notes|
That’s basically it folks. Enjoy.
Raw data
{
"_id": null,
"home_page": "https://github.com/xaratustrah/dolphinlog",
"name": "dolphinlog",
"maintainer": "",
"docs_url": null,
"requires_python": "<4,>=3.7",
"maintainer_email": "",
"keywords": "HAM,Logging,Amateur Radio,QSO",
"author": "xaratustrah",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/6e/ce/275412d661948511e9ecdc115c9d0d342591d6b08b0051c35c4f73d53d8d/dolphinlog-0.2.10.tar.gz",
"platform": null,
"description": "# dolphinlog\n<img src=\"https://github.com/xaratustrah/dolphinlog/raw/main/rsrc/dolphin.png\" width=\u201c128\u201d>\n\n_This program has been renamed to **`dolphinlog`** in order to avoid naming conflict with another software. But as you can see, the logo still shows the original animal as icon!_\n\n`dolphinlog` is a program for amateur radio [(HAM)](https://en.wikipedia.org/wiki/Amateur_radio) operators for their daily use. There are tons of HAM log programs out there. This is yet another one, aiming to be free, modern but as well ultra simple by using only the command line interface in order to store QSO data in a SQLite database. An export function to ADIF-3 \\*.adi is also available.\n\nThere are no editors, this means that the database file should be viewed using standard viewer programs, of which also many exist. Some examples are standalone programs such as [sqlitebrowser](https://github.com/sqlitebrowser/sqlitebrowser) or browser plugins such as [this one](https://addons.mozilla.org/en-US/firefox/addon/sqlite-manager/). This leaves the HAM a great deal of freedom to import, export in/to any format and manage the database. The typical usage of such a log program is for running on an ideally small or embedded computer such as [RaspberryPi2](https://en.wikipedia.org/wiki/Raspberry_Pi), as a HAM computer, where possibly also other HAM related software such as [fldigi](https://sourceforge.net/projects/fldigi/) are running, or HAM related hardware attached, such as [dongles](http://www.funcubedongle.com/) are also running. The name of this program is inspired by other HAM radio logger software available on the internet that have an animal name\nin their title.\n\n#### Installation\n\n`dolphinlog` is by nature platform independent. The simplest way to install it is to use PyPI:\n\n pip install dolphinlog\n\nOther than that `dolphinlog` needs just a working Python 3 installation. So whatever OS you have, just put the script\nsomewhere you can call it, e.g. by symbolic linking like this:\n \n ln -s dolphinlog /usr/local/bin/dolphinlog\n\n#### Usage\nJust type:\n\n dolphinlog\n \nIn the command line and the program starts. If you like to skip an entry, just press enter. If no command line arguments are given at invocation time, then the program creates a folder in the home directory:\n\n ~/.dolphinlog/dolphinlog.sqlite\n\notherwise a specific database filename can be given by the `-db` switch. `-v` switch increases the verbosity. If the switch `-adi` is provided, then an `*.adi` file is exported. For this export either the default database file name is used, or a database filename should be given.\n\n#### DB Fields and ADIF-3 export\n\n\n`dolphinlog` supports export to function to the ADIF3 \\*.adi format. The [ADIF 3](http://adif.org/) standard has a very comprehensive list of fields. In order to find a minimalistic implementation of export function, `dolphinlog` adapts the minimum ADIF record fields required by the website [eQSL](https://www.eqsl.cc), but also includes additional fields. Minimum ADIF-3 fields required by eQSL:\n\n|Field | Description|\n|-------|-------------|\n|QSO_DATE| date on which the QSO started YYYYMMDD|\n|TIME_ON| QSO time in UTC|\n|CALL| the contacted station's Callsign|\n|MODE| QSO Mode|\n|BAND| QSO Band|\n\nADIF-3 fields fields recommended by eQSL:\n\n|Field | Description|\n|-------|-------------|\n|FREQ| QSO frequency in Megahertz|\n|PROP_MODE| QSO propagation mode|\n|PROGRAMID| identifies the name of the logger, converter, or utility that created or processed this ADIF file|\n|QSLMEG| QSL card message|\n|RST_SENT| signal report sent to the contacted station|\n\n\nADIF-3 fields additionally used by `dolphinlog`:\n\n|Field | Description|\n|-------|-------------|\n| NAME | the contacted station's operator's name |\n| RST_RCVD | signal report from the contacted station|\n|RX_PWR | the contacted station's transmitter power in watts|\n|TX_PWR | the logging station's power in watts|\n|GRIDSQUARE | the contacted station's 2-character, 4-character, 6-character, or 8-character Maidenhead Grid Square|\n|NOTES | QSO Notes|\n\n\nThat\u2019s basically it folks. Enjoy.\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Yet another HAM radio logger using SQLite with ADIF-3 export support.",
"version": "0.2.10",
"split_keywords": [
"ham",
"logging",
"amateur radio",
"qso"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6ece275412d661948511e9ecdc115c9d0d342591d6b08b0051c35c4f73d53d8d",
"md5": "6a73925a73e1cf571889db3f755f6107",
"sha256": "e95311b15b582a80fd3028231ed637df64d131a6a67aaafd1a6ca688a118f591"
},
"downloads": -1,
"filename": "dolphinlog-0.2.10.tar.gz",
"has_sig": false,
"md5_digest": "6a73925a73e1cf571889db3f755f6107",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.7",
"size": 18828,
"upload_time": "2023-02-06T23:29:57",
"upload_time_iso_8601": "2023-02-06T23:29:57.942916Z",
"url": "https://files.pythonhosted.org/packages/6e/ce/275412d661948511e9ecdc115c9d0d342591d6b08b0051c35c4f73d53d8d/dolphinlog-0.2.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-06 23:29:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "xaratustrah",
"github_project": "dolphinlog",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dolphinlog"
}
JSON
