Skip to main content

A tool to plan your next trip

Project description

Otripy - An open trip planning tool

PyPI Version License Downloads Supported Versions Contributors

Description

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!

Current features:

  • 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)

Screenshots

Otripy GUI snapshot

Installation

For users familiar with Python

Otripy is on PyPi. To install it, run:

pip install otripy

For all others

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

Usage

To launch the application:

otripy

Building and publishing

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"

Contributing

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.

License

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.

Credits

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


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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

otripy-1.1.0.tar.gz (25.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

otripy-1.1.0-py3-none-any.whl (27.8 kB view details)

Uploaded Python 3

File details

Details for the file otripy-1.1.0.tar.gz.

File metadata

  • Download URL: otripy-1.1.0.tar.gz
  • Upload date:
  • Size: 25.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.3

File hashes

Hashes for otripy-1.1.0.tar.gz
Algorithm Hash digest
SHA256 af7a1c573b28b34a0b816de83f2463db4beee7bd6dd20132b5599d768cba1403
MD5 19cb5a99254cdd2ed0bbd203808770ce
BLAKE2b-256 7d041ce12ca50b202b2ff3953ca1ecf9d38d91ffc5ff1164927d23fbd8c6090a

See more details on using hashes here.

File details

Details for the file otripy-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: otripy-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 27.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.3

File hashes

Hashes for otripy-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c493a145f98df5764d4b16bb335ba9a10af24a160c93b4926c68b87404ee00ad
MD5 7869ec4062c85b3173a694e75199dcf2
BLAKE2b-256 3a5022b7a48fc6666ae92f8e70ef2a488db6542aaa40abbd8fefbbce39b29f0b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page