Scarriffle/Flaro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Halo heisst ab hier Flaro — die Marke stand im Weg

Browse Source 
Der Upload zu App Store Connect scheiterte am Namen. „Halo" ist eine
eingetragene Marke von Microsoft; im App Store heisst zwar keine App exakt
so, aber reservierte und markenrechtlich belegte Namen tauchen in keiner
Suche auf. Der einzige verlässliche Test war die Eingabe dort, und die ging
daneben.

**Der Name wurde diesmal vorher geprüft.** Zwanzig Kandidaten gegen den
deutschen und amerikanischen App Store, auf exakte Treffer und auf ähnliche
Namen. „Kavo" wäre dieselbe Wand gewesen — exakt belegt in beiden Stores, in
Deutschland von KaVo Dental GmbH. „Flare" ist mit 42 ähnlichen Apps je Store
der am dichtesten besetzte Name der ganzen Runde. **Flaro** ist in beiden
frei und liest sich als eigenes Wort, nicht als Flare mit Tippfehler.

Das bleibt eine Store-Suche und keine Markenrecherche — reservierte Namen
ohne veröffentlichte App sieht sie nicht. Aber es ist mehr Prüfung, als beim
letzten Mal stattfand.

---

2160 Textvorkommen in 273 Dateien, 49 Pfade. Betroffen ist diesmal auch der
Server: `Flaro.Api`, `Flaro.Core`, `Flaro.Data`, `Flaro.Media`,
`Flaro.Metadata`, `FlaroContext`, `FlaroPaths`, `flaro.db`, die Variablen
`FLARO_DATA`, `FLARO_CACHE`, `FLARO_TRANSCODE`, `FLARO_WRITE_SIDECARS`, und
das Image.

**Vor dem Ersetzen geprüft**, ob „halo" irgendwo als Teil eines anderen
Wortes steckt — und ob es im TMDB-Token vorkommt. Tat es nicht; ein blindes
Ersetzen hätte den sonst zerlegt.

`docs/superpowers/specs/` bleibt wie beim letzten Mal unangetastet: datierte
Entwurfsdokumente sind ein Protokoll getroffener Entscheidungen. Das
Server-Dokument hat stattdessen einen Nachtrag bekommen, damit es niemanden
in die Irre führt.

**Die Bundle-ID wandert mit**, zum zweiten Mal an einem Tag:
`com.scarriffleservices.flaro`. Wer die vorige Fassung installiert hat, hat
jetzt zwei Karteileichen auf dem Gerät — beide löschen, dann ist Ruhe.

308 Server-Tests grün, 368 im Swift-Paket, null Warnungen. iOS und tvOS
bauen, das Image baut, und ein frischer Container läuft durch Einrichtung
und Anmeldung.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-10-03 19:38:27 +02:00
co-authored by Claude Opus 5
parent f98b995050
commit a7cf6c5def
390 changed files with 2078 additions and 2069 deletions
Download Patch File Download Diff File Expand all files Collapse all files
server/README.md
+29 -29
View File
@@ -1,4 +1,4 @@
# Halo-Server
# Flaro-Server
Ein Medienserver, der dieselben Dinge kann wie Jellyfin — und zwei, die dort
nicht gehen.
@@ -7,7 +7,7 @@ nicht gehen.
Metadaten — und **Download mit allen Ton- und Textspuren**, der Grund für
dieses Projekt. Was noch fehlt: Streamen mit Umrechnen (HLS), Fortschritt und
Gesehen-Status, Live TV. Der Entwurf samt Begründungen steht
in [`docs/superpowers/specs/2026-10-03-halo-server-design.md`](../docs/superpowers/specs/2026-10-03-halo-server-design.md).
in [`docs/superpowers/specs/2026-10-03-flaro-server-design.md`](../docs/superpowers/specs/2026-10-03-flaro-server-design.md).
## Warum
@@ -35,13 +35,13 @@ Administratorkonto an. Danach verschliesst sich dieser Weg von selbst.
| Variable | Bedeutung | Voreinstellung im Image |
|---|---|---|
| `HALO_DATA` | Datenbank und Einstellungen. **Das Einzige, was gesichert werden muss.** | `/config` |
| `HALO_CACHE` | Bilder und Zwischenstände. Darf verlorengehen. | `/cache` |
| `HALO_TRANSCODE` | Kratzplatz fürs Umrechnen. Am besten auf eine SSD. | `/transcode` |
| `FLARO_DATA` | Datenbank und Einstellungen. **Das Einzige, was gesichert werden muss.** | `/config` |
| `FLARO_CACHE` | Bilder und Zwischenstände. Darf verlorengehen. | `/cache` |
| `FLARO_TRANSCODE` | Kratzplatz fürs Umrechnen. Am besten auf eine SSD. | `/transcode` |
| `ASPNETCORE_URLS` | Worauf gelauscht wird | `http://+:8080` |
| `TZ` | Zeitzone | `UTC` |
| `HALO_RATELIMIT_SIGNIN` | Anmeldeversuche je Minute und Adresse | `10` |
| `HALO_RATELIMIT_POLLING` | Nachfragen je Minute und Adresse | `120` |
| `FLARO_RATELIMIT_SIGNIN` | Anmeldeversuche je Minute und Adresse | `10` |
| `FLARO_RATELIMIT_POLLING` | Nachfragen je Minute und Adresse | `120` |
**Medienpfade stehen hier nicht.** Sie werden in der Oberfläche als
Bibliotheken angelegt und liegen in der Datenbank — sonst müsste der Container
@@ -60,7 +60,7 @@ diese Meldung stünde dort nur „unable to open database file".
### Hardware fürs Umrechnen
`/dev/dri` durchreichen — VAAPI deckt Intel wie AMD ab. Fehlt es, rechnet Halo
`/dev/dri` durchreichen — VAAPI deckt Intel wie AMD ab. Fehlt es, rechnet Flaro
in Software; das ist langsamer, aber es läuft. **Zum blossen Umpacken wird gar
keine Hardware gebraucht**, und das ist der Weg, der den meisten Beständen
hilft.
@@ -69,7 +69,7 @@ hilft.
```bash
dotnet test # 293 Tests
dotnet run --project src/Halo.Api # auf http://localhost:5000
dotnet run --project src/Flaro.Api # auf http://localhost:5000
```
Ohne gesetzte Variablen legt der Server `data/`, `cache/` und `transcode/`
@@ -77,10 +77,10 @@ neben dem Programm an.
```bash
# Image bauen, beide Architekturen
docker buildx build --platform linux/amd64,linux/arm64 -t halo:dev .
docker buildx build --platform linux/amd64,linux/arm64 -t flaro:dev .
# Eine Migration nach einer Modelländerung
dotnet ef migrations add <Name> --project src/Halo.Data --startup-project src/Halo.Api --output-dir Migrations
dotnet ef migrations add <Name> --project src/Flaro.Data --startup-project src/Flaro.Api --output-dir Migrations
```
Migrationen wandern **beim Start** des Servers, nicht über ein eigenes
@@ -90,13 +90,13 @@ Kommando.
| Projekt | Aufgabe |
|---|---|
| `Halo.Core` | Domäne: Benutzer, Anmeldung, Bibliotheken. Kennt kein HTTP und keine Datenbank |
| `Halo.Data` | EF Core, SQLite, Migrationen |
| `Halo.Media` | ffprobe und ffmpeg. Als eigene Prozesse, nicht eingebunden |
| `Halo.Metadata` | TMDB und die Bildablage. Hinter einer Schnittstelle, damit alles andere ohne Netz prüfbar bleibt |
| `Halo.Api` | Endpunkte, Authentifizierung, Auslieferung der Oberfläche |
| `Flaro.Core` | Domäne: Benutzer, Anmeldung, Bibliotheken. Kennt kein HTTP und keine Datenbank |
| `Flaro.Data` | EF Core, SQLite, Migrationen |
| `Flaro.Media` | ffprobe und ffmpeg. Als eigene Prozesse, nicht eingebunden |
| `Flaro.Metadata` | TMDB und die Bildablage. Hinter einer Schnittstelle, damit alles andere ohne Netz prüfbar bleibt |
| `Flaro.Api` | Endpunkte, Authentifizierung, Auslieferung der Oberfläche |
Was sicherheitsrelevant ist, liegt in `Halo.Core` — dort ist es ohne Server
Was sicherheitsrelevant ist, liegt in `Flaro.Core` — dort ist es ohne Server
prüfbar, und die Tests dazu sind die, die am meisten wert sind.
### Zwei Entscheidungen, die beim Lesen Fragen aufwerfen
@@ -133,7 +133,7 @@ und ändert sich dabei.
### Metadaten
**Halo bringt einen TMDB-Zugang mit** — es läuft ohne Einrichtung. Wer lieber
**Flaro bringt einen TMDB-Zugang mit** — es läuft ohne Einrichtung. Wer lieber
seinen eigenen benutzt, hinterlegt ihn unter `PUT /api/v1/settings/metadata`;
der sticht den mitgelieferten. Abgefragt werden kann nur, *ob* einer da ist und
ob es der mitgelieferte ist — der Zugang selbst kommt nie zurück.
@@ -144,8 +144,8 @@ in der Adresse, und kann nur lesen) oder der ältere **API Key**.
Die Sprache steht auf `en-US` und wird in denselben Einstellungen umgestellt.
Bilder werden einmal heruntergeladen und liegen unter `HALO_CACHE`. Die App
holt sie bei Halo, nicht bei TMDB: sonst bräuchte sie dafür Internet, und TMDB
Bilder werden einmal heruntergeladen und liegen unter `FLARO_CACHE`. Die App
holt sie bei Flaro, nicht bei TMDB: sonst bräuchte sie dafür Internet, und TMDB
erführe, wer wann was ansieht.
**Der Hinweis auf TMDB ist Pflicht, keine Höflichkeit.** Deren Bedingungen
@@ -182,12 +182,12 @@ geschehen.
**Umgepackt wird auf die Platte, nicht in die Antwort.** Der bequeme Weg wäre,
ffmpeg unmittelbar durchzureichen — dann kennt aber niemand die Länge im
Voraus: kein Fortschrittsbalken, kein Fortsetzen, kein Springen. Dafür gibt es
`HALO_TRANSCODE`.
`FLARO_TRANSCODE`.
| Variable | Bedeutung | Voreinstellung |
|---|---|---|
| `HALO_FFMPEG` | Pfad zu ffmpeg | `ffmpeg` |
| `HALO_FFPROBE` | Pfad zu ffprobe | `ffprobe` |
| `FLARO_FFMPEG` | Pfad zu ffmpeg | `ffmpeg` |
| `FLARO_FFPROBE` | Pfad zu ffprobe | `ffprobe` |
## Zuordnung korrigieren
@@ -213,7 +213,7 @@ Nur Administratoren, denn es ändert die Mediathek für alle.
## Beiwerk im Medienordner
Mit `HALO_WRITE_SIDECARS=true` legt Halo Plakate, Hintergründe und
Mit `FLARO_WRITE_SIDECARS=true` legt Flaro Plakate, Hintergründe und
NFO-Dateien neben den Film:
```
@@ -230,20 +230,20 @@ Serien bekommen `tvshow.nfo` eine Ebene über dem Staffelordner, Folgen je eine
NFO und ein Standbild neben der Datei.
**Standardmässig aus**, und die Medieneinhängung muss dafür ohne `:ro`
auskommen. Was Halo schreiben darf, steht als Erlaubnisliste im Code
auskommen. Was Flaro schreiben darf, steht als Erlaubnisliste im Code
(`SidecarNames`): alles andere wird abgelehnt, und Mediendateien werden nie
geändert, umbenannt oder gelöscht. Transcode-Zwischenstände kommen nie in
einen Medienordner — die liegen unter `HALO_TRANSCODE`.
einen Medienordner — die liegen unter `FLARO_TRANSCODE`.
**Gelesen wird auch ohne Schreiberlaubnis.** Eine vorhandene NFO ist eine
Zuordnung, die jemand getroffen hat; Halo nimmt sie und sucht gar nicht erst.
Zuordnung, die jemand getroffen hat; Flaro nimmt sie und sucht gar nicht erst.
Dasselbe gilt für Ordnernamen der Form `Der Untergang (2004) [tmdbid-613]` —
Halo liest sie, benennt aber **nichts** um. Umbenennen ist der einzige
Flaro liest sie, benennt aber **nichts** um. Umbenennen ist der einzige
Eingriff, der eine Bibliothek wirklich zerlegen kann.
| Variable | Bedeutung | Voreinstellung |
|---|---|---|
| `HALO_WRITE_SIDECARS` | Beiwerk in den Medienordner schreiben | `false` |
| `FLARO_WRITE_SIDECARS` | Beiwerk in den Medienordner schreiben | `false` |
## Anmeldung am Fernseher