Kerosene is a lightweight, compact and intuitive application allowing users to record and permanently store flight information in a personal microdatabase. The program has a number of features:
- A panel providing miscellaneous database and flight information
- Navigable list allowing users to view/retrieve flights by date
- A menu providing basic database management functionalities
- A search by date tool to quickly retrieve flight Data
- Facilities to export data to Excel and JSON formats
- A dashboard to visually display flight routes on a map
Kerosene currently runs only on Windows. The easiest way to obtain, install and run the software is to download the Windows installer provided in the releases page. A zipped folder version of the software is also available should you wish to unzip and run the software from a location of your choice.
If you wish to install kerosene from source you should be aware that the program is only compatible with Python 3.
A requirements.txt file is provided to install all python modules needed to
run the program. Run
pip install -r requirements.txt to install them.
In addition Kerosene needs the Matplotlib Basemap Toolkit to visually display data. To install the Basemap Toolkit either:
- Install from binary making sure you follow the official installation guidelines.
- Download a wheel distribution file from here
making sure that you select a version compatible and supported by your Python.
Then run
pip install basemap-<your_version>.whlto install.
The program is distributed under the terms of the the MIT License. This license is what is generally known as the "MIT License", aka "X11 License", "MIT/X Consortium License", "Expat License". See here.
This license is GPL-compatible. See here and here.
It is a permissive free software license, meaning that it permits reuse within proprietary software provided all copies of the licensed software include a copy of the MIT License terms and the copyright notice. Such proprietary software retains its proprietary nature even though it incorporates software under the MIT License.
As part of it's flight finder facility Kerosene uses tkentrycomplete.py a tkinter widget that features autocompletion created by Mitja Martini on 2008-11-29. This is a subclass of tkinter.Entry that features autocompletion and can be found on Tkinter's Wiki page at http://tkinter.unpythonic.net/wiki/AutocompleteEntry.
Kerosene is able to export data to .xlsx spreadsheet files thanks to openpyxl, a Python library written by Eric Gazoni and also distributed under MIT license. Openpyxl's website can be found at: https://openpyxl.readthedocs.org/en/latest/
In addition Kerosene's flame and Json icons are being used under a Creative Commons Attribution 3.0 Unported License. More information on this license can be found at https://creativecommons.org/licenses/by/3.0/ The authors of these icons can be found at http://www.aha-soft.com/ and http://p.yusukekamiyamane.com/ respectively.
All other icons used in the program, and their author are found at http://www.famfamfam.com/
This project adheres to Semantic Versioning. A CHANGELOG file is provided in the docs folder.