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.
Metadata
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 | Provenance | |
|---|---|---|---|---|
| liveisstracker-2.2.2.tar.gz | 1.7 MB | Without provenance | 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}
|
Security for liveisstracker 2.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.