Skip to main content

GitHub Skyline (Alternative)

Export STL Python License

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!

GitHub Skyline Render


вњЁ 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

img.png

CLI Mode:

python -m github_skyline --help
python -m github_skyline -u your-username -y 2024

рџ“– Detailed Usage

  1. Install the package:

    pip install github-skyline
    
  2. Launch GUI:

    python -m github_skyline
    
  3. Or use CLI:

    python -m github_skyline -u your-username -y 2024
    

[DEPRECATED] Method 2: Standalone Binaries

  1. Download: Go to Releases and download the appropriate binary for your system:

    Release Assets

  2. Extract the downloaded archive

  3. Run the application:

    Windows:

    • Double-click skyline-wizard.exe

    Windows Example

    macOS/Linux:

    ./skyline-wizard.bin
    

    Linux Example

рџ”§ CLI Options

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

рџЋ‰ 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)

Source distribution for github-skyline 1.0.2
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)

Table of built distributions (wheels) for github-skyline 1.0.2
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page