README.md
Rama main · réplica de lectura del repositorio original.
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/stellarium-banner-dark.png">
<img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/stellarium-banner.png" alt="Stellarium: clear skies, guaranteed" width="100%">
</picture>
</p>
<p align="center">
<a href="https://github.com/junkerderprovinz/stellarium/actions/workflows/build.yml"><img src="https://img.shields.io/github/actions/workflow/status/junkerderprovinz/stellarium/build.yml?branch=main&label=Build&style=for-the-badge&logo=githubactions&logoColor=white" alt="Build" height="36"></a>
<a href="https://github.com/junkerderprovinz/stellarium/actions/workflows/lint.yml"><img src="https://img.shields.io/github/actions/workflow/status/junkerderprovinz/stellarium/lint.yml?branch=main&label=Lint&style=for-the-badge&logo=githubactions&logoColor=white" alt="Lint" height="36"></a>
<a href="https://hub.docker.com/r/junkerderprovinz/stellarium"><img src="https://img.shields.io/docker/pulls/junkerderprovinz/stellarium?style=for-the-badge&logo=docker&logoColor=white&label=Pulls&color=1d99f3" alt="Docker Pulls" height="36"></a>
<a href="https://hub.docker.com/r/junkerderprovinz/stellarium"><img src="https://img.shields.io/docker/image-size/junkerderprovinz/stellarium/latest?style=for-the-badge&logo=docker&logoColor=white&label=Size&color=1d99f3" alt="Image Size" height="36"></a>
<a href="https://github.com/junkerderprovinz/stellarium/pkgs/container/stellarium"><img src="https://img.shields.io/badge/Arch-amd64%20%7C%20arm64-success?style=for-the-badge&logo=linux&logoColor=white" alt="Arch" height="36"></a>
<a href="https://github.com/Stellarium/stellarium"><img src="https://img.shields.io/badge/Engine-Stellarium-191970?style=for-the-badge&logoColor=white" alt="Stellarium" height="36"></a>
<a href="https://ca.unraid.net/apps/stellarium-1we6aez0jcmlhj"><img src="https://img.shields.io/badge/Unraid-Template-f15a2c?style=for-the-badge&logo=unraid&logoColor=white" alt="Unraid" height="36"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue?style=for-the-badge&logo=gnu&logoColor=white" alt="License: AGPL-3.0" height="36"></a>
</p>
<p align="center">
<b>Stellarium, in your browser.</b> Explore the night sky from any device. No VNC client, no local install.<br>
This runs the full Stellarium desktop planetarium inside a single container and streams it to your
browser over <a href="https://github.com/selkies-project/selkies">Selkies</a> (H.264 video), so panning
the sky, zooming into a nebula and scrubbing through time stay smooth, the part of a real-time
planetarium where the old noVNC containers feel laggy.
</p>
<br>
<p><a id="table-of-contents" href="#table-of-contents"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sections/table-of-contents-dark.svg"><img src=".github/assets/sections/table-of-contents.svg" alt="Table of Contents" width="100%"></picture></a></p>
1. [Download](#1-download)
2. [Support](#2-support)
3. [What it looks like](#3-what-it-looks-like)
4. [What it does](#4-what-it-does)
5. [Getting started](#5-getting-started)
6. [How AI is used here](#6-how-ai-is-used-here)
<br>
<p><a id="1-download" href="#1-download"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sections/1-download-dark.svg"><img src=".github/assets/sections/1-download.svg" alt="1. Download" width="100%"></picture></a></p>
<!-- download-buttons: written by scripts/gen_download_buttons.py -->
<p align="center">
<picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sections/group-server-dark.svg"><img src=".github/assets/sections/group-server.svg" alt="Server" width="100%"></picture>
</p>
<p align="center">
<a href="https://ca.unraid.net/apps/stellarium-1we6aez0jcmlhj"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(0,0,841.9,245.3))" alt="Install from Unraid's Community Applications" width="160" height="46.618"></a>
<a href="https://mos-official.net/apps.html?search=Stellarium"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(866,0,841.9,245.3))" alt="Install from the MOS Hub" width="160" height="46.618"></a>
<a href="https://github.com/junkerderprovinz/zimaos-apps#install"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(1732,0,841.9,245.3))" alt="Install from the ZimaOS and CasaOS store" width="160" height="46.618"></a>
<a href="https://github.com/junkerderprovinz/umbrel-apps#install"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(2598,0,841.9,245.3))" alt="Install from the umbrelOS community app store" width="160" height="46.618"></a>
</p>
<p align="center">
<a href="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/compose.yaml"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(3464,0,841.9,245.3))" alt="Download the docker-compose file" width="160" height="46.618"></a>
<a href="https://github.com/junkerderprovinz/stellarium/releases/latest"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(4330,0,841.9,245.3))" alt="Download the source archive" width="160" height="46.618"></a>
</p>
<!-- /download-buttons -->
<br>
<p><a id="2-support" href="#2-support"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sections/2-support-dark.svg"><img src=".github/assets/sections/2-support.svg" alt="2. Support" width="100%"></picture></a></p>
<p align="center">
A one-knight job: I build it, keep it running, work through the issues and add what people ask for, until nothing is missing. It is free, with no accounts, no telemetry, no ads and no paid tier. No asterisk anywhere. Nothing readable ever leaves your own walls. Forged on evenings and weekends, with heart and stubbornness.
</p>
<p align="center">
If it has earned a place on your server or computer, toss a coin to your knight: it helps cover the costs and keeps the project alive. It also makes this knight's heart beat a little faster. Three ways below, whichever suits you.
</p>
<!-- give-buttons: written by scripts/gen_download_buttons.py -->
<p align="center">
<a href="https://buymeacoffee.com/junkerderprovinz"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(5196,0,841.9,245.3))" alt="Buy me a coffee" width="160" height="46.618"></a>
<a href="https://www.paypal.com/donate/?hosted_button_id=76FVV52TKXTUS"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(6062,0,841.9,245.3))" alt="PayPal" width="160" height="46.618"></a>
<a href="https://junkerderprovinz.github.io/junkerderprovinz/"><img src="https://raw.githubusercontent.com/junkerderprovinz/stellarium/main/.github/assets/download-buttons/buttons.svg?v=509c6fbfa82d#svgView(viewBox(6928,0,841.9,245.3))" alt="Donate with crypto" width="160" height="46.618"></a>
</p>
<!-- /give-buttons -->
<br>
<p><a id="3-what-it-looks-like" href="#3-what-it-looks-like"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sections/3-what-it-looks-like-dark.svg"><img src=".github/assets/sections/3-what-it-looks-like.svg" alt="3. What it looks like" width="100%"></picture></a></p>
The pictures come from a test instance set to Alice Springs on a July night.
<p align="center">
<img src=".github/assets/screenshots/stellarium-1.png" alt="Stellarium in a browser window: the Milky Way from Crux to Cygnus, with constellation lines and names" width="100%">
<br><em>The full desktop Stellarium in a browser tab, streamed from the container</em>
</p>
<p align="center">
<img src=".github/assets/screenshots/stellarium-2.png" alt="Stellarium zoomed into Scorpius with the constellation art on, showing the data panel for Antares" width="100%">
<br><em>Click any object for its data, here Antares with the constellation art switched on</em>
</p>
<br>
<p><a id="4-what-it-does" href="#4-what-it-does"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sections/4-what-it-does-dark.svg"><img src=".github/assets/sections/4-what-it-does.svg" alt="4. What it does" width="100%"></picture></a></p>
- **The real program.** The only other way to have Stellarium in a browser is Stellarium Web, a separate and much lighter rewrite. This is the full desktop app with its plugins, catalogues and sky cultures, installed from Debian trixie's `stellarium` package for amd64 and arm64.
- **A smooth sky.** Selkies streams the desktop as H.264 video, so dragging across the sky and speeding up time stay fluid where a noVNC desktop stutters.
- **GPU optional.** A GPU passed into the container is used; without one, Stellarium renders in software and still works.
- **Sized to your window.** The desktop follows your browser window, so there is no screen size to set and memory grows only with the window you use.
- **Nothing lost on updates.** Your location, downloaded catalogues, landscapes, plugins and screenshots live under `/config`.
<br>
<p><a id="5-getting-started" href="#5-getting-started"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sections/5-getting-started-dark.svg"><img src=".github/assets/sections/5-getting-started.svg" alt="5. Getting started" width="100%"></picture></a></p>
On Unraid, install **Stellarium** from [Community Applications](https://ca.unraid.net/apps/stellarium-1we6aez0jcmlhj). Anywhere else, one container is enough:
```sh
docker run -d --name stellarium -p 3001:3001 --shm-size=1gb \
-v /path/to/config:/config \
junkerderprovinz/stellarium:latest
```
Then open `https://<server>:3001` and accept the self-signed certificate once. Stellarium starts maximised; press `F6` to set your location, and `F2` opens the configuration window with the plugins.
> [!NOTE]
> The WebUI has no login by default, for use on a trusted LAN. Set `CUSTOM_USER` and `PASSWORD` to turn on the built-in login, and never expose the WebUI to the internet without a VPN or an authenticating reverse proxy in front.
### Other Docker hosts
[compose.yaml](compose.yaml) runs Stellarium on any Linux server with Docker. Put it in a folder of its own and start it with `docker compose up -d`. The folders are created next to the file.
- **Synology:** in Container Manager, create a project from the file (DSM 7.2 or newer).
- **Proxmox:** run it in a VM or an LXC container that has Docker.
- **MOS:** install Stellarium from the [MOS Hub](https://mos-official.net/apps.html?search=Stellarium).
- **ZimaOS and CasaOS:** add the [community store](https://github.com/junkerderprovinz/zimaos-apps#install) and install Stellarium from it.
- **umbrelOS:** add the [community app store](https://github.com/junkerderprovinz/umbrel-apps#install) and install Stellarium from it.
<br>
<p><a id="6-how-ai-is-used-here" href="#6-how-ai-is-used-here"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sections/6-how-ai-is-used-here-dark.svg"><img src=".github/assets/sections/6-how-ai-is-used-here.svg" alt="6. How AI is used here" width="100%"></picture></a></p>
One knight builds this, and AI is one of the tools I work with, the same way I work with an editor or a compiler. It helps me write code and documentation and it checks my work, and that saves me a good many evenings. It does not make the decisions, though. I read and understand everything before it ships, and if something here breaks, that is on me and not on the tool.
You do not have to take my word for it. The code is open and every release note is written by hand. The issue tracker shows how problems actually get handled, including the ones I got wrong the first time. If you find something that is not right, open an issue and I will look at it.
<br>
Questions, bugs, ideas or feature requests? Please [open a GitHub issue](https://github.com/junkerderprovinz/stellarium/issues).
<br>
<sub>[Stellarium](https://github.com/Stellarium/stellarium) is GPL-2.0 software by the Stellarium developers, and this project is not affiliated with or endorsed by it. The packaging here is AGPL-3.0; see [LICENSE](LICENSE) and [NOTICE](NOTICE) for the bundled software.</sub>