GitHub Skyline (Alternative)
An alternative implementation of GitHub Skyline that generates 3D models of your GitHub contribution history.
Transform your GitHub contributions into stunning 3D landscapes that you can 3D print, display, or share!
вњЁ Features
- рџЋЇ Faithful Design: Follows the original GitHub Skyline design (unlike the official CLI)
- рџ–ҐпёЏ Multiple Interfaces: GUI, CLI, and Python library support
- 📦 Cross-Platform: Works on Windows, macOS, and Linux
- рџЋЁ STL Export: Ready-to-print 3D models
- рџљЂ Easy Installation: Simple pip install or standalone binaries
рџљЂ Quick Start
Installation
pip install github-skyline
Generate Your Skyline
GUI Mode:
python -m github_skyline
CLI Mode:
python -m github_skyline --help
python -m github_skyline -u your-username -y 2024
рџ“– Detailed Usage
Method 1: Python Package (Recommended)
-
Install the package:
pip install github-skyline
-
Launch GUI:
python -m github_skyline
-
Or use CLI:
python -m github_skyline -u your-username -y 2024
[DEPRECATED] Method 2: Standalone Binaries
-
Download: Go to Releases and download the appropriate binary for your system:
-
Extract the downloaded archive
-
Run the application:
Windows:
- Double-click
skyline-wizard.exe
macOS/Linux:
./skyline-wizard.bin
- Double-click
рџ”§ CLI Options
Available Commands
| Option | Description | Example |
|---|---|---|
-u, --username |
GitHub username | -u doctorixx |
-y, --year |
Year to generate | -y 2024 |
-o, --output |
Output filename | -o my-skyline.stl |
-h, --help |
Show help message | --help |
Examples
# Generate skyline for user 'doctorixx' for 2024
python -m github_skyline -u doctorixx -y 2024
# Custom output filename
python -m github_skyline -u doctorixx -y 2024 -o my-contributions.stl
Official CLI Differences: While GitHub has released an official CLI tool, it uses a different design. This project maintains compatibility with the original GitHub Skyline website design.
рџ“ќ License
This project is licensed under the MIT License - see the LICENSE file for details.
рџ¤ќ Support
- рџђ› Bug Reports: Open an issue
- рџ’Ў Feature Requests: Start a discussion
- рџ“§ Questions: Check existing issues or start a new discussion
рџЋ‰ Showcase
Share your GitHub Skylines! Tag us or open a discussion to show off your 3D printed contributions.
Made with вќ¤пёЏ by the community | Star вђ this repo if you find it useful!
Metadata
Release files for github-skyline 1.0.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 | Actions |
|---|---|---|---|---|
| github_skyline-1.0.2.tar.gz | 600.5 kB | Without provenance | Details for github_skyline-1.0.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| github_skyline-1.0.2-py3-none-any.whl | Python 3 | none | any | Details for github_skyline-1.0.2-py3-none-any.whl |
Total release size: 1.2 MB
Release files / github_skyline-1.0.2.tar.gz
| Download URL | github_skyline-1.0.2.tar.gz |
|---|---|
| Size | 600.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5f4d46fd63ee02e06682dfab95cff29cc13a8c318647cebba3eb28bcb55b1d94
|
|
BLAKE2b-256 checksum How to use checksums |
061ab5872607376399f33aaab176b475a96ab3bc9ef884376bb2f2b011d6d58e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.5
|
Release files / github_skyline-1.0.2-py3-none-any.whl
| Download URL | github_skyline-1.0.2-py3-none-any.whl |
|---|---|
| Size | 618.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8ccfca4ddd601d7dd2164d68de7341ed1441cd2bc4641c9b0f7cde4613b941c0
|
|
BLAKE2b-256 checksum How to use checksums |
2322cf3c9327b6ed7a788760e760d283b156eee0a6b927875e9da69c70c0cce5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.5
|
Security for github-skyline 1.0.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.