Live ISS Tracker
🛰️ A simple desktop application and CLI that tracks the real-time location of the International Space Station.
https://github.com/user-attachments/assets/6284dc17-650c-485c-b73b-92c596f66a4a
Quick Start
This application provides two main commands:
run: Launches the interactive 3D globe in a desktop window.location: Prints the current latitude and longitude of the ISS to the console.
To use these commands, make sure you have a modern version of Python and uv installed, then simply run:
# To run the GUI application
uvx --from liveisstracker iss run
# To get the current location in your terminal
uvx --from liveisstracker iss location
Other Ways to Run
Using pipx
If you have pipx installed, you can use it to run the commands in an isolated environment:
pipx run --spec liveisstracker iss run
pipx run --spec liveisstracker iss location
Using pip
You can also install the package directly into your Python environment using pip:
# Install the package
pip install liveisstracker
# Run the commands
iss run
iss location
Development
To contribute to the development of this project, you can set it up locally:
-
Clone the repository:
git clone https://github.com/manojmanivannan/liveisstracker.git cd liveisstracker
-
Run the application commands: The included
run.shscript usesuvto install dependencies and run the app in a local virtual environment. You can pass the subcommands to it:# Run the GUI ./run.sh run # Get the location ./run.sh location
Versioning and Releasing
This project includes an interactive script to simplify the process of versioning and creating new releases.
To create a new version, run:
./version_tag_push
This script will guide you through bumping the version number, creating a new Git tag, and pushing the tag to the remote repository. Pushing a new tag will automatically trigger the GitHub Actions workflow to publish the new version to PyPI.
1 maintainer
Release files for liveisstracker 2.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| liveisstracker-2.2.2.tar.gz | 1.7 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| liveisstracker-2.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.7 MB
Release files / liveisstracker-2.2.2.tar.gz
| Download URL | liveisstracker-2.2.2.tar.gz |
|---|---|
| Size | 1.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e8dfbb9a52cc96086ce2dcb7b6ac7d62ed9a6ee420f61efa5c1a9dd610aa4340
|
|
BLAKE2b-256 checksum How to use checksums |
195072bb09ec441115fdb57b2a4b48d925b29730f861cc26db30d80d9c829536
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / liveisstracker-2.2.2-py3-none-any.whl
| Download URL | liveisstracker-2.2.2-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
44b80383465a4298e97439f2c3024140258c0d1b8e361ed48e54d534b4c92143
|
|
BLAKE2b-256 checksum How to use checksums |
9cec31cdd4471e7a5b850ad8facbd350727081059a6323617d4b865cef53d699
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
