Skip to content

charliej2005/terminal-solar-system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Terminal Solar System

This Python project runs a simple ASCII solar system in your Unix terminal.

Example Solar System

It's also my first Boot.dev personal project, and showcases some of the Python skills I've picked up while following their Backend Developer course.

Note: unlike the guided projects, this project is entirely my own.


Features

  • Animated ASCII planets and stars
  • Vibrant color support made possible with Rich
  • Dynamically adapts to terminal rescaling
  • Easy CLI exit by pressing the 'q' key during runtime

Setup

  1. Clone the repo:

    git clone https://github.com/charliej2005/terminal-solar-system.git
    cd terminal-solar-system
  2. Install dependencies:

    pip install -r requirements.txt
  3. Run the project:

    python3 main.py
  4. Optional flags:

    • --color: Enable vibrant color output
    • --random: Generate a random solar system
    • --fps FPS: Set frames per second (default: 30)
    • --stars STARS: Set number of background stars (default: 100)
    • --x-scale X_SCALE: Set terminal font aspect ratio (default: 2.2)

Have fun! :)

This tool is not accurate to real-world orbits. If you're an astronomer, please avert your eyes!

About

a mini ASCII solar system for your Unix terminal

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages