Otripy is a GUI application for trip planning, providing an intuitive user interface for organizing travel visits efficiently. Otripy allows to plan a trip by adding markers on a map (based on OpenStreetMap) associated with a note.

Otripy is developed and daily tested on Linux. It should work on any platform. It has already been tested on MacOS.

Otripy is already usable but would be better with a lot of other features. Some wanted features are listed here. Don't hesitate to create a new issue if you think at other features. And contribute them if you can!

• Display OpenStreetMap map
• Zoom and pan the map
• Adding location markers on the map
• List existing location on the left part of the GUI
• Associate a note to a location. The first line of the note is used as the title in the list
• Search location by name, and add a new marker when selecting an entry in the list
• Delete markers
• Open and save local files
• Open and save files on any Nextcloud server you have access to
• Note text formatting (heading, bold, …)
• Image insertion (copy paste only currently)
• Change location markers icon and color

Otripy is on PyPi. To install it, run:

pip install otripy

If you are not used to installing Python packages, the simplest method is probably to use uv. Please install it first. Then, open a terminal and create an uv virtual environment and activate it:

uv venv otripy
source otripy/bin/activate

Then install Otripy and run it:

uv pip install otripy
otripy

When you want to restart Otripy later, open your terminal, and run:

source otripy/bin/activate
otripy

Finally, to upgrade Otripy, to a new version, run:

source otripy/bin/activate
uv pip install otripy --upgrade

To launch the application:

otripy

Otripy uses uv, please install it if not already available.

If you just cloned this repository, cd to it and then:

uv venv
uv sync --all-extras
uv pip install -r pyproject.toml --extra build
install -d dist

Then, to build and publish:

rm dist/otripy-*
bumpver update --patch # or --minor or --major
uv build
uv publish
uv sync --all-extras
git add uv.lock
git commit -m "Update lock to new package version"

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature-name).
3. Commit changes (git commit -m "Add feature").
4. Push to your branch (git push origin feature-name).
5. Open a pull request.

This project is Free Software, licensed under the AGPL License. See the AGPL file for details. In summary: you can use it, share it, change it, redistribute your changes, but any version you offer, with or without changes must be under the same (or a compatible) license.

Otripy is developed and maintained by Kleag. Special thanks to all contributors!

For more information, visit the GitHub repository or the PyPI page.