{"id":15021293,"url":"https://github.com/blindbyte98/astro","last_synced_at":"2026-01-24T10:36:12.291Z","repository":{"id":252961801,"uuid":"842030982","full_name":"BlindByte98/ASTRO","owner":"BlindByte98","description":"ASTRO is a realistic 3D procedural star system simulator that offers immersive exploration of celestial mechanics using scientifically accurate models.","archived":false,"fork":false,"pushed_at":"2024-08-14T22:51:35.000Z","size":52,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T10:51:11.149Z","etag":null,"topics":["3d","3d-graphics","astronomy","astrophysics","computer-graphics","educational","html","javascript","open-source","physics","procedural-generation","rendering","research","science","scientific-research","simulation","space","threejs","visualization","web-development"],"latest_commit_sha":null,"homepage":"https://blindbyte98.github.io/ASTRO/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BlindByte98.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-13T14:29:01.000Z","updated_at":"2024-08-15T17:01:28.000Z","dependencies_parsed_at":"2024-09-23T22:02:03.094Z","dependency_job_id":null,"html_url":"https://github.com/BlindByte98/ASTRO","commit_stats":{"total_commits":14,"total_committers":1,"mean_commits":14.0,"dds":0.0,"last_synced_commit":"016380fe6bfbcb511880f5079daea5c690ee35b9"},"previous_names":["blindbyte98/astro"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlindByte98%2FASTRO","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlindByte98%2FASTRO/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlindByte98%2FASTRO/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlindByte98%2FASTRO/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlindByte98","download_url":"https://codeload.github.com/BlindByte98/ASTRO/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238590593,"owners_count":19497351,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","3d-graphics","astronomy","astrophysics","computer-graphics","educational","html","javascript","open-source","physics","procedural-generation","rendering","research","science","scientific-research","simulation","space","threejs","visualization","web-development"],"created_at":"2024-09-24T19:56:24.610Z","updated_at":"2025-10-28T03:31:00.521Z","avatar_url":"https://github.com/BlindByte98.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ASTRO\n\n---\n\n## 🌟 Overview\n\nASTRO is a cutting-edge 3D procedural star system simulation that offers a realistic and immersive exploration of celestial mechanics. Developed using [Three.js](https://threejs.org/), ASTRO combines high-fidelity visuals with detailed physics and astrophysical modeling to create a scientifically accurate simulation of star systems.\n\n![ax](https://github.com/user-attachments/assets/bab92f5d-ce84-4a7e-9a58-efdc3c963384)\n\n---\n\n## 📑 Table of Contents\n\n1. [🚀 Live Demo](#-live-demo)\n2. [📝 Changelog](#-changelog)\n3. [✨ Features](#-features)\n    - [Realistic Simulation](#realistic-simulation)\n    - [Detailed Physical Properties](#detailed-physical-properties)\n    - [Immersive Visuals](#immersive-visuals)\n    - [Accurate Center of Mass](#accurate-center-of-mass)\n    - [Supported Objects](#supported-objects)\n4. [🚀 Installation](#-installation)\n5. [📖 Usage](#-usage)\n6. [⚙️ Configuration](#-configuration)\n7. [🤝 Contributing](#-contributing)\n8. [📝 License](#-license)\n9. [🙏 Acknowledgments](#-acknowledgments)\n10. [📬 Contact](#-contact)\n\n---\n\n## 🚀 Live Demo\n\nExperience the simulation in action by visiting the [Live Demo](https://blindbyte98.github.io/ASTRO/). The project and demo were tested and developed on a semi-modern Windows desktop PC using the Google Chrome browser.\n\n---\n\n## 📝 Changelog\n\nCheck out the [Changelog](https://github.com/BlindByte98/ASTRO/blob/main/CHANGELOG.md) for updates.\n\n---\n\n## ✨ Features\n\n### Realistic Simulation\n\n- **Celestial Bodies**: Models a range of star types and planetary systems with scientifically accurate properties.\n- **Star Systems**: Simulates single and multi-star systems with realistic mass distributions. Stars are dynamically positioned based on their mass and gravitational influence.\n- **Planets and Moons**: Generates planets and moons with realistic sizes, orbits, and rotational properties. Each object’s velocity and position are calculated to ensure stable, physically accurate interactions.\n- **Orbital Mechanics**: Uses Newtonian gravity and elliptical orbits to model planetary and moon trajectories. Advanced orbital dynamics include accurate velocities and escape velocities to prevent unrealistic spiraling.\n- **Asteroids and Nebulae**: Incorporates asteroid fields and nebulae with procedurally generated particles for added realism.\n- **Dynamic Rings**: Supports the creation of ring systems around planets with realistic textures and dynamic indicators.\n\n![binary](https://github.com/user-attachments/assets/3b86d9a1-54a6-46e5-9aee-583ab5f1387c)\n\n### Detailed Physical Properties\n\n- **Mass and Gravity**: Celestial bodies are assigned realistic masses and gravitational constants, affecting their interactions and orbital behavior.\n- **Size and Scale**: Objects are scaled based on real astronomical measurements, ensuring accurate relative sizes and distances.\n- **Velocity and Acceleration**: Implements realistic velocities for objects, preventing issues like spiraling into the central star. Velocity calculations account for gravitational forces and initial placements.\n- **Spin and Rotation**: Incorporates dynamic spin rates and rotational properties for stars, planets, and moons, based on astrophysical data.\n\n![Star](https://github.com/user-attachments/assets/e89861b2-ca49-488f-bb69-94c1d203a887)\n\n### Immersive Visuals\n\n- **Textures and Materials**: Applies detailed textures and realistic materials to celestial objects, enhancing visual fidelity.\n- **Lighting**: Utilizes ambient and point lighting to simulate natural illumination, including effects like star brightness and planetary shadows.\n- **Post-Processing Effects**: Includes bloom and other post-processing effects for a more cinematic and immersive experience.\n- **Interactive Exploration**: Provides intuitive camera controls for an immersive user experience, allowing users to explore the simulation from various angles.\n\n![Star2](https://github.com/user-attachments/assets/a58e340f-cfb0-46c7-a52f-fbea3d475961)\n\n### Accurate Center of Mass\n\n- **System Dynamics**: Calculates the center of mass for multi-star systems, ensuring that all bodies orbit realistically around this central point.\n\n![star3](https://github.com/user-attachments/assets/7cd97547-dbeb-4292-a618-e31908c48e15)\n\n### Supported Objects\n\nASTRO currently supports a variety of celestial objects, each with unique characteristics and behaviors:\n\n- **Stars**:\n  - **Main Sequence**: The most common type of star, including stars like our Sun.\n  - **Red Giant**: Large, aging stars with expanded outer layers.\n  - **White Dwarf**: Dense, compact remnants of medium-sized stars.\n  - **Blue Giant**: Massive, hot stars with high luminosity.\n  - **Supergiant**: Extremely large and luminous stars, often in the final stages of their evolution.\n\n![Starx](https://github.com/user-attachments/assets/97fc1c02-3615-4be5-b600-0bfaee4a3440)\n\n- **Planets**:\n  - **Terrestrial Planets**: Rocky planets similar to Earth, with solid surfaces.\n  - **Gas Giants**: Large planets with thick gaseous atmospheres, like Jupiter.\n  - **Ice Giants**: Planets with icy compositions, such as Uranus and Neptune.\n  - **Dwarf Planets**: Small planetary bodies that do not dominate their orbits, like Pluto.\n\n![moon](https://github.com/user-attachments/assets/b7ef23a6-9976-491f-9b52-1efe91ac84fe)\n\n- **Moons**:\n  - **Rocky Moons**: Moons with solid surfaces, similar to Earth's Moon.\n  - **Icy Moons**: Moons with significant ice coverage, like Europa.\n\n- **Asteroids**:\n  - **Asteroid Belts**: Collections of rocky bodies, varying in size, orbiting a star.\n\n- **Nebulae**:\n  - **Nebula Particles**: Clouds of gas and dust particles that add depth and realism to the star system.\n\n- **Rings**:\n  - **Planetary Rings**: Rings composed of dust, rock, and ice that orbit around planets.\n\n---\n\n## 🚀 Installation\n\nTo run ASTRO locally, follow these steps:\n\n1. **Clone the Repository**:\n\n    ```bash\n    git clone https://github.com/BlindByte98/ASTRO\n    ```\n\n2. **Navigate to the Project Directory**:\n\n    ```bash\n    cd ASTRO\n    ```\n\n3. **Open the `index.html` File**:\n\n    Open the `index.html` file in your web browser to view the simulation. Alternatively, serve it locally using a simple HTTP server.\n\n    ```bash\n    npx http-server\n    ```\n\n4. **Access the Simulation**:\n\n    Open your browser and go to `http://localhost:8080` (or the port specified by your HTTP server).\n\n---\n\n## 📖 Usage\n\nExplore the star system with interactive controls, observe celestial dynamics, and adjust simulation settings for a personalized experience.\n\n---\n\n## ⚙️ Configuration\n\nModify simulation parameters in the `index.html` file to adjust star types, planetary properties, and orbital mechanics.\n\n---\n\n## 🤝 Contributing\n\nWe welcome and value contributions to the **ASTRO** simulation. To ensure our project’s quality and consistency, please adhere to the following principles:\n\n### Contribution Principles\n\nAs the original creator of **ASTRO**, I, BlindByte, value contributions that align with these core principles:\n\n- **Scientific Accuracy:** Ensure all updates are based on established physics and astrophysics to maintain the simulation's scientific integrity.\n- **Realism:** Enhance the authentic portrayal of celestial mechanics and astronomical phenomena for a true-to-life experience.\n- **Immersiveness:** Enrich the simulation’s depth and beauty, creating a captivating representation of the universe.\n- **Focus on Physics:** Prioritize accurate physical simulations, reflecting realistic dynamics and interactions among celestial bodies.\n\nBy adhering to these principles, you help make **ASTRO** a premier tool for both educational and research purposes. Thank you for your contributions!\n\n---\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\n- **[Three.js](https://threejs.org/)**: For providing the powerful 3D rendering library.\n- **[OrbitControls](https://threejs.org/examples/#orbitcontrols)**: For interactive camera controls.\n\n---\n\n## 📬 Contact\n\nThis software was created by **BlindByte**. Connect with me:\n\n- **Website**: [www.BlindByte.me](https://www.blindbyte.me)\n- **Twitter / X**: [@BlindByte](https://twitter.com/BlindByte)\n\nFor questions or further information, feel free to reach out via the above links.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblindbyte98%2Fastro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblindbyte98%2Fastro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblindbyte98%2Fastro/lists"}