MERIDIAN 816 - network service / Netzdienst
Version 2.4 (2026-11-19) - retro-modern.net - free / kostenlos

ENGLISH

Unzip this package into the root of the MiSTer's SD card (/media/fat/). It
puts the service into linux/meridian/, the song index for SID JAM into
games/MERIDIAN/HVSC/ and two samples for KONTOR into games/MERIDIAN/files/.
Then add these lines to /media/fat/linux/user-startup.sh and restart the
MiSTer (updating: just unzip the new package over the old one and restart
the MiSTer, the lines stay):

if [ "$1" = "start" ] && [ -f /media/fat/linux/meridian/draht.py ]; then
	cd /media/fat/linux/meridian
	setsid nohup python3 -u draht.py > /tmp/draht.log 2>&1 < /dev/null &
	echo $! > /tmp/draht.pid
	cd /
fi

What it does: the BASIC NET commands, drive 3 (the folder
games/MERIDIAN/files), the TIEFGANG ranking, and for the HORIZONT desktop
RADIO, SID JAM, WEATHER and the weather in the menu bar, NEWS, ATLAS's
browser page (http://<your MiSTer>:816/) and downloads, TAKTSTOCK's net
jam, JPG, PNG and GIF pictures on drive 3 for PICTURES and PAINT,
the app KATALOG (software from retro-modern.net/katalog.html),
printing for NOTES, PAINT and the KONTOR apps (WRITE, CALC, FILE, DRAW),
and the connection and music for the online game HANSE&HIEBE (HANSE.MER).
It only works while the MERIDIAN core is loaded and leaves other cores
alone.
games/MERIDIAN is the folder the MiSTer itself uses for the core: on a USB
drive (MERIDIAN or games/MERIDIAN) if there is one - also when plugged in
later - otherwise on the SD card. Drive 3, the browser page, the weather
settings and SID JAM's HVSC follow it.

SID JAM solo: unpack the HVSC (hvsc.c64.org, a .7z file), zip its folder
C64Music into one file and put it at games/MERIDIAN/HVSC/hvsc.zip. The
index here is for HVSC #85. Without it the tunes come from the JAM server - for linked
devices only (F8 in the app links your forum account). On first use the
service writes hvsc.zip.liste next to it (the zip's table of contents -
later starts take a second instead of 20).
RADIO: your own stations go into games/MERIDIAN/files/RADIO.TXT, one per
line as Name|http://address. For the cover art the service looks up the
current title at iTunes, so the title goes to Apple. REC in RADIO (1.1 and
newer) records the station as an MP3 file on drive 3 (SLAY0001.MP3 ...,
with station, date and the titles in the ID3 tag); RECORDINGS plays it or
any other MP3 from drive 3.
WEATHER: nothing is asked before you open the app once (switching the
weather in the menu bar off in SETTINGS does not count). Then the service
gets the place from your IP address at ip-api.com (or from the search at
Open-Meteo) and the weather for it from Open-Meteo every 15 minutes. Place
and settings are kept in games/MERIDIAN/wetter.json.
NEWS: the service fetches tagesschau.de, heise online and the Retro-Modern
forum only when the app asks (one source at most every 5 minutes).
KATALOG: the list comes from retro-modern.net only when the app asks (at
most every 5 minutes); LOAD downloads the file from there.
PRINTING: "Print to PDF" saves an A4 PDF on drive 3. "Print" sends it to a
network printer that takes PDF (IPP Everywhere / AirPrint can do that):
the first line of games/MERIDIAN/files/PRINTER.TXT (an address like
192.168.1.20, a name or ipp://.../ipp/print), or without that file the
first printer the service finds in your network (Bonjour).
KONTOR samples: C64GAMES.FIL (a card file with 56 C64 games) for FILE and
MERIDIAN.DRW (a block diagram of the computer) for DRAW come along in
games/MERIDIAN/files, i.e. drive 3. Unzipping the package again resets
them - save your own changes under another name.

Licenses: sidkern is our own code, GPL-3.0-or-later; its source is in
sidkern-quelle/. sidton contains reSID by Dag Lem (GPL-2.0-or-later);
sidton.cpp itself is GPL-3.0-or-later, and both sources and the license are
in sidton-quelle/. bildwandler uses stb_image and
stb_image_write by Sean Barrett (public domain / MIT); its source is in
bildwandler-quelle/. Everything else: (c) 2026
retro-modern.net, free to use and to pass on unchanged. The HVSC is not
included; the index is made from the song lengths and STIL of HVSC #85.

Changes:
2.4 (2026-11-19)  For HORIZONT 2.6: stars in KATALOG. Keys 1-5 in a
                  description (or the menu Rate) send a rating to
                  retro-modern.net - one per MERIDIAN, it can't be changed
                  later. The service creates a random device ID for this
                  the first time and keeps it, with your ratings, in
                  games/MERIDIAN/katalog.json; the server only stores a
                  hash of it. The list shows the average.
2.3 (2026-11-19)  For HORIZONT 2.5: the app KATALOG. The service fetches the
                  list from retro-modern.net/katalog.html (at most every
                  5 minutes, only when the app asks), checks each download
                  against its SHA-256 and puts it on drive 3; ZIP packages
                  are unpacked (games/MERIDIAN/... onto the SD card).
                  Descriptions in German or English (D/E in the app, kept
                  in games/MERIDIAN/katalog.json).
2.2 (2026-11-07)  Music for HANSE&HIEBE on the MERIDIAN: the network service
                  plays the game's SID tunes with reSID, like "Original" in
                  SID JAM (needs HANSE.MER version 3).
2.1 (2026-11-07)  For HANSE&HIEBE on the MERIDIAN (HANSE.MER): a plain
                  network connection to the game server (LEITUNG). The
                  source of sidkern is now included (sidkern-quelle/, GPL-3)
                  like that of sidton. SID JAM can switch between the songs
                  of a SID file - for the next HORIZONT.
2.0 (2026-10-31)  For HORIZONT 2.4: printing. NOTES, PAINT and the new
                  office apps in the KONTOR folder print to a network
                  printer or save an A4 PDF on drive 3 - WRITE with fonts
                  and pictures, CALC with grid and chart, FILE as list,
                  cards or labels (3 x 8, 3 x 7, 2 x 8), DRAW as vectors.
1.9 (2026-10-29)  RADIO: the spectrum moves with what you hear - it ran up
                  to 1.5 s ahead. SID JAM: instead of "kein SJE-Strom" the
                  app says why a tune does not play (NOT A SID FILE, NO
                  SONG 9, SIDKERN CRASHED - REINSTALL ...); details in
                  /tmp/draht.log. Copy the files in binary mode (FTP).
                  For HORIZONT 2.3: PICTURES shows JPG, PNG and GIF from
                  drive 3 (scaled to the screen), the new app PAINT opens
                  and saves them (320 x 200, 208 colors). RADIO 1.2 plays
                  in 32 kHz and 12 bits (before: 22 kHz, 8 bits); the
                  RADIO of HORIZONT 2.2 keeps working as before.
1.8 (2026-10-27)  For HORIZONT 2.2: RADIO records the station as an MP3
                  file on drive 3 (REC) and plays recordings and other MP3
                  files from drive 3 (RECORDINGS). Reading the directory of
                  drive 3 no longer stops RADIO or SID JAM - only reading
                  and writing files does.
1.7 (2026-10-23)  Drive 3 and everything else in games/MERIDIAN can live on
                  a USB drive: the service takes the folder the MiSTer
                  takes (USB before SD card) and follows when a drive is
                  plugged in or pulled out.
1.6 (2026-10-22)  SID JAM: without your own HVSC only linked devices get
                  tunes from the server. Instead of "LOAD FAILED: HTTP
                  Error 401" the app now says so: LINK FORUM ACCOUNT (F8)
                  OR ADD THE HVSC.
1.5 (2026-10-21)  For HORIZONT 2.1: switching the weather in the menu bar
                  off in SETTINGS does not wake the weather service.
1.4 (2026-10-20)  News for HORIZONT 2.0: the app NEWS with tagesschau.de,
                  heise online and the Retro-Modern forum.
1.3 (2026-10-13)  Weather for HORIZONT 1.2: the app WEATHER (now and five
                  days, place search, Celsius or Fahrenheit) and the short
                  form in the menu bar.
1.2 (2026-10-12)  SID JAM: digi tunes (samples through the volume register,
                  thousands of writes per second) no longer stutter with the
                  reSID sound - the service now reads the register stream
                  about six times faster.
1.1 (2026-10-12)  SID JAM: tunes no longer end early, and the next one no
                  longer starts late or halfway through. reSID is kept warm
                  for the next tune (it needed 3 s to start), the first tune
                  after power-on is quick, jingles and TAKTSTOCK songs are
                  converted much faster. For the notes that hung on between
                  two tunes, update HORIZONT to 1.1 as well.
1.0 (2026-10-11)  First release.

DEUTSCH

Das Paket ins Hauptverzeichnis der SD-Karte des MiSTer entpacken
(/media/fat/). Der Dienst landet in linux/meridian/, der Index fuer SID JAM
in games/MERIDIAN/HVSC/, zwei Beispiele fuer KONTOR in games/MERIDIAN/files/.
Danach die Zeilen oben in /media/fat/linux/user-startup.sh eintragen und
den MiSTer neu starten.
Aktualisieren: das neue Paket einfach ueber das alte entpacken und den
MiSTer neu starten, die Zeilen bleiben.

Was er macht: die BASIC-Befehle NET, Laufwerk 3 (der Ordner
games/MERIDIAN/files), die TIEFGANG-Rangliste und fuer den Schreibtisch
HORIZONT: RADIO, SID JAM, WEATHER und das Wetter in der Menueleiste, NEWS,
die Browser-Seite von ATLAS (http://<MiSTer>:816/) und Downloads, den
Netz-Jam von TAKTSTOCK, JPG-, PNG- und GIF-Bilder auf Laufwerk 3 fuer
PICTURES und PAINT, die App KATALOG (Software von
retro-modern.net/katalog.html), das Drucken fuer NOTES, PAINT und die Apps im Ordner
KONTOR (WRITE, CALC, FILE, DRAW) und Verbindung und Musik fuer das
Online-Spiel HANSE&HIEBE (HANSE.MER). Er arbeitet nur, solange der
MERIDIAN-Core laeuft, und laesst andere Cores in Ruhe.
games/MERIDIAN ist der Ordner, den der MiSTer selbst fuer den Core nimmt:
auf einem USB-Laufwerk (MERIDIAN oder games/MERIDIAN), wenn es einen gibt -
auch spaeter eingesteckt -, sonst auf der SD-Karte. Laufwerk 3, die
Browser-Seite, die Wetter-Einstellungen und die HVSC von SID JAM ziehen mit.

SID JAM allein: die HVSC (hvsc.c64.org, eine .7z-Datei) auspacken, ihren
Ordner C64Music in eine Datei zippen und als games/MERIDIAN/HVSC/hvsc.zip
ablegen. Der Index hier gehoert
zur HVSC #85. Ohne sie kommen die Stuecke vom JAM-Server - nur fuer
gekoppelte Geraete (F8 in der App koppelt das Forumskonto). Beim ersten Mal
legt der Dienst hvsc.zip.liste daneben (das Inhaltsverzeichnis der Zip -
danach dauert der Start eine Sekunde statt 20).
RADIO: eigene Sender in games/MERIDIAN/files/RADIO.TXT, je Zeile
Name|http://adresse. Fuer das Cover sucht der Dienst den laufenden Titel bei
iTunes, der Titel geht dafuer an Apple. REC in RADIO (ab 1.1) schneidet den
Sender als MP3-Datei auf Laufwerk 3 mit (SLAY0001.MP3 ..., mit Sender, Datum
und den Titeln im ID3-Tag); RECORDINGS spielt sie oder jede andere MP3 von
Laufwerk 3.
WEATHER: Bevor die App einmal offen war, fragt der Dienst niemanden (das
Wetter in der Menueleiste in SETTINGS abschalten zaehlt nicht). Danach
holt er den Ort aus der IP-Adresse bei ip-api.com (oder aus der Suche bei
Open-Meteo) und dazu alle 15 Minuten das Wetter von Open-Meteo. Ort und
Einstellungen stehen in games/MERIDIAN/wetter.json.
NEWS: Der Dienst holt tagesschau.de, heise online und das Retro-Modern-Forum
nur, wenn die App fragt (eine Quelle hoechstens alle 5 Minuten).
KATALOG: Die Liste kommt nur, wenn die App fragt, von retro-modern.net
(hoechstens alle 5 Minuten); LOAD laedt die Datei von dort.
DRUCKEN: "Print to PDF" legt ein A4-PDF auf Laufwerk 3 ab. "Print" schickt
es an einen Netzwerkdrucker, der PDF annimmt (IPP Everywhere / AirPrint
koennen das meist): die erste Zeile von games/MERIDIAN/files/PRINTER.TXT
(eine Adresse wie 192.168.1.20, ein Name oder ipp://.../ipp/print), ohne
diese Datei der erste Drucker, den der Dienst im Heimnetz findet (Bonjour).
Beispiele fuer KONTOR: C64GAMES.FIL (eine Kartei mit 56 C64-Spielen) fuer
FILE und MERIDIAN.DRW (ein Blockschaltbild des Rechners) fuer DRAW liegen
in games/MERIDIAN/files, also auf Laufwerk 3. Wer das Paket erneut
entpackt, setzt sie zurueck - eigene Aenderungen unter anderem Namen sichern.

Lizenzen: sidkern ist eigener Code, GPL-3.0 oder spaeter; der Quelltext
liegt in sidkern-quelle/. sidton enthaelt reSID von Dag Lem (GPL-2.0 oder
spaeter), sidton.cpp selbst ist GPL-3.0 oder spaeter; Quelltexte und Lizenz
liegen in sidton-quelle/. bildwandler nutzt stb_image
und stb_image_write von Sean Barrett (gemeinfrei / MIT); Quelltext in
bildwandler-quelle/. Alles andere: (c) 2026
retro-modern.net, kostenlos nutzen und unveraendert weitergeben. Die HVSC
liegt nicht bei; der Index ist aus Liedlaengen und STIL der HVSC #85.

Aenderungen:
2.4 (19.11.2026)  Fuer HORIZONT 2.6: Sterne im KATALOG. Die Tasten 1-5 in
                  einer Beschreibung (oder das Menue Rate) schicken eine
                  Bewertung an retro-modern.net - eine je MERIDIAN, danach
                  nicht mehr aenderbar. Dafuer legt der Dienst beim ersten
                  Mal eine zufaellige Geraetekennung an und merkt sie mit
                  deinen Bewertungen in games/MERIDIAN/katalog.json; der
                  Server speichert nur einen Hash davon. Die Liste zeigt
                  den Schnitt.
2.3 (19.11.2026)  Fuer HORIZONT 2.5: die App KATALOG. Der Dienst holt die
                  Liste von retro-modern.net/katalog.html (hoechstens alle
                  5 Minuten, nur wenn die App fragt), prueft jeden Download
                  gegen seine SHA-256 und legt ihn auf Laufwerk 3; ZIP-
                  Pakete packt er aus (games/MERIDIAN/... auf die SD-Karte).
                  Beschreibungen deutsch oder englisch (D/E in der App,
                  gemerkt in games/MERIDIAN/katalog.json).
2.2 (07.11.2026)  Musik fuer HANSE&HIEBE am MERIDIAN: der Netzdienst spielt
                  die SID-Stuecke des Spiels mit reSID, wie "Original" in
                  SID JAM (ab HANSE.MER Fassung 3).
2.1 (07.11.2026)  Fuer HANSE&HIEBE am MERIDIAN (HANSE.MER): eine einfache
                  Netzverbindung zum Spielserver (LEITUNG). Der Quelltext
                  von sidkern liegt jetzt bei (sidkern-quelle/, GPL-3), wie
                  der von sidton. SID JAM kann zwischen den Liedern einer
                  SID-Datei wechseln - fuer die naechste HORIZONT.
2.0 (31.10.2026)  Fuer HORIZONT 2.4: Drucken. NOTES, PAINT und die neuen
                  Buero-Apps im Ordner KONTOR drucken auf einem
                  Netzwerkdrucker oder legen ein A4-PDF auf Laufwerk 3 ab -
                  WRITE mit Schriften und Bildern, CALC mit Gitter und
                  Diagramm, FILE als Liste, Karten oder Etiketten (3 x 8,
                  3 x 7, 2 x 8), DRAW als Vektoren.
1.9 (29.10.2026)  RADIO: Das Spektrum laeuft mit dem, was man hoert - es
                  war bis zu 1,5 s voraus. SID JAM: Statt "kein SJE-Strom"
                  sagt die App, warum ein Stueck nicht spielt (NOT A SID
                  FILE, NO SONG 9, SIDKERN CRASHED - REINSTALL ...);
                  Einzelheiten in /tmp/draht.log. Dateien im Binaermodus
                  kopieren (FTP). Fuer HORIZONT 2.3: PICTURES zeigt JPG,
                  PNG und GIF von Laufwerk 3 (auf den Schirm skaliert), die
                  neue App PAINT oeffnet und sichert sie (320 x 200, 208
                  Farben). RADIO 1.2 spielt mit 32 kHz und 12 Bit (vorher
                  22 kHz, 8 Bit); das RADIO aus HORIZONT 2.2 laeuft wie
                  bisher weiter.
1.8 (27.10.2026)  Fuer HORIZONT 2.2: RADIO schneidet den Sender als
                  MP3-Datei auf Laufwerk 3 mit (REC) und spielt Aufnahmen
                  und andere MP3-Dateien von Laufwerk 3 (RECORDINGS). Das
                  Verzeichnis von Laufwerk 3 lesen haelt RADIO und SID JAM
                  nicht mehr an - nur Dateien lesen und schreiben.
1.7 (23.10.2026)  Laufwerk 3 und alles andere in games/MERIDIAN darf auf
                  einem USB-Laufwerk liegen: Der Dienst nimmt den Ordner,
                  den der MiSTer nimmt (USB vor SD-Karte), und zieht mit,
                  wenn ein Laufwerk eingesteckt oder abgezogen wird.
1.6 (22.10.2026)  SID JAM: Ohne eigene HVSC bekommen nur gekoppelte Geraete
                  Stuecke vom Server. Statt "LOAD FAILED: HTTP Error 401"
                  sagt die App das jetzt: LINK FORUM ACCOUNT (F8) OR ADD
                  THE HVSC.
1.5 (21.10.2026)  Fuer HORIZONT 2.1: das Wetter in der Menueleiste in
                  SETTINGS abschalten weckt den Wetterdienst nicht.
1.4 (20.10.2026)  Nachrichten fuer HORIZONT 2.0: die App NEWS mit
                  tagesschau.de, heise online und dem Retro-Modern-Forum.
1.3 (13.10.2026)  Wetter fuer HORIZONT 1.2: die App WEATHER (jetzt und fuenf
                  Tage, Ortssuche, Celsius oder Fahrenheit) und die
                  Kurzform in der Menueleiste.
1.2 (12.10.2026)  SID JAM: Digi-Stuecke (Samples ueber das Lautstaerke-
                  register, tausende Zugriffe je Sekunde) stottern im Klang
                  reSID nicht mehr - der Dienst liest den Registerstrom jetzt
                  etwa sechsmal schneller.
1.1 (12.10.2026)  SID JAM: Stuecke brechen nicht mehr zu frueh ab, und das
                  naechste beginnt nicht mehr verspaetet oder mittendrin.
                  reSID bleibt fuers naechste Stueck vorgewaermt (brauchte
                  3 s zum Start), das erste Stueck nach dem Einschalten kommt
                  schnell, Jingles und TAKTSTOCK-Songs werden viel schneller
                  umgerechnet. Gegen Toene, die zwischen zwei Stuecken
                  stehen blieben: HORIZONT ebenfalls auf 1.1 bringen.
1.0 (11.10.2026)  Erste Ausgabe.
