Mus-Eq — μουσικός server και player που τον τρέχεις μόνος σου

Το Mus-Eq είναι ένας μουσικός server και player που τον τρέχεις μόνος σου. Ένας μικρός server σε Rust κρατά τη βιβλιοθήκη σου και τη σερβίρει μέσα από ένα τεκμηριωμένο API. Πάνω του μιλάνε ένας web player στο Webamp, με την κλασική όψη του Winamp, και μια πρώιμη εφαρμογή για Android. Είναι ανοιχτού κώδικα, με άδεια MIT ή Apache-2.0.

Είναι ακόμη στην αρχή του και αλλάζει. Ο server και ο web player δουλεύουν· τα έχω δοκιμάσει τοπικά, σε headless browser και από ένα κινητό στο σπίτι, μέσα από το ίδιο δίκτυο· όχι ακόμη με Podman ή σε μεγάλη βιβλιοθήκη.

Τι δουλεύει σήμερα

• Βιβλιοθήκη: σάρωση φακέλου, ανάγνωση tags, αναζήτηση που αγνοεί τόνους και κεφαλαία (και στα ελληνικά), streaming με Range.
• Web player: Webamp, σύνδεση, αναζήτηση, playlists, ανέβασμα και επιλογή skin.
• Playlists που μεγαλώνουν μόνες τους: όταν τελειώνει μια playlist, προστίθενται τραγούδια από καλλιτέχνες που δεν έχει ήδη, στο ίδιο είδος, από τη δική σου βιβλιοθήκη.
• Διπλά αρχεία: εντοπισμός από το αποτύπωμα του ήχου, με πρόταση για το ποιο να κρατήσεις. Δεν σβήνεται ποτέ τίποτα.
• Προτάσεις για tags: από το MusicBrainz, και από το AcoustID αν βάλεις δικό σου κλειδί. Αλλάζουν τη βάση μόνο αν τις αποδεχτείς· τα αρχεία ήχου δεν ξαναγράφονται ποτέ.
• Ραδιόφωνα: λίστα σταθμών με αναζήτηση και έλεγχο για το ποιοι παίζουν (μέσα υπάρχει ελληνική λίστα), κι ένα ραδιόφωνο από τα δικά σου αρχεία. Μετατροπή σε opus, mp3 ή aac την ώρα που παίζει.
• Εφαρμογή Android (πρώιμη): αναζήτηση, playlists, ραδιόφωνα, σταθμοί, αναπαραγωγή στο παρασκήνιο, και τραγούδια offline που ελέγχονται με το μέγεθος και το SHA-256 του server.

Αναζήτηση στα ελληνικά χωρίς τόνο, και η ελληνική λίστα σταθμών.

Προγράμματα τρίτων, μόνο αν το πεις

Το Mus-Eq δεν έχει μέσα ούτε ffmpeg, ούτε yt-dlp, ούτε deno. Όταν χρειαστεί κάποιο, ο server σου δείχνει τι θα κατεβάσει, από πού, πόσο μεγάλο είναι, γιατί και με ποια άδεια, και περιμένει να το επιβεβαιώσεις. Το αρχείο ελέγχεται με SHA-256 καρφωμένο στην έκδοση πριν χρησιμοποιηθεί. Αν έχεις ήδη δικό σου ffmpeg, χρησιμοποιείται αυτό και δεν κατεβαίνει τίποτα.

Η εφαρμογή Android

Υπάρχει μόνο σαν debug build, που το φτιάχνεις από τον φάκελο android/, και την έχω δοκιμάσει σε ένα κινητό (OnePlus 13) στο σπίτι. Εκεί δοκίμασα με το χέρι: τα offline τραγούδια παίζουν με τον server σταματημένο, ένα χαλασμένο αρχείο διορθώνεται με το «Check pinned copies», και το token αποθηκεύεται κρυπτογραφημένο. Με την εξαίρεση μπαταρίας ενεργή, έπαιξε περίπου 35 λεπτά με την οθόνη κλειστή· μια ολόκληρη ώρα δεν την έχω τρέξει.

Τι δεν είναι έτοιμο ή δεν έχει ελεγχθεί

• Clients για Windows και Linux, skins στο Android, ζωντανό ραδιόφωνο από το μικρόφωνο του κινητού: δεν υπάρχουν ακόμη.
• Οι τίτλοι τραγουδιών στο ραδιόφωνο από τα δικά σου αρχεία έχουν τεστ, αλλά δεν έχουν δοκιμαστεί ακόμη σε VLC ή σε browser. Ένα ραδιόφωνο τρέχει για 24 ώρες και δεν έχει βγάλει ακόμη αποτέλεσμα.
• Το HTTPS δεν έχει δοκιμαστεί με πραγματικό πιστοποιητικό.
• Το κατέβασμα από YouTube Music ή Spotify είναι κλειστό από προεπιλογή και δεν έχει τρέξει ποτέ πάνω στις πραγματικές υπηρεσίες.
• Τα downloads για ARM δεν έχουν τρέξει.

Η πλήρης λίστα, φάση προς φάση, είναι στο roadmap.

Πως το δοκιμάζεις

Με Docker: φτιάχνεις ένα .env με το token σου, βάζεις μουσική στον φάκελο music και τρέχεις docker compose up --build. Ο player ανοίγει στο http://127.0.0.1:8080/. Όλες οι λεπτομέρειες είναι στο README. Issues για bugs, ιδέες και σταθμούς είναι ανοιχτά στο GitHub.

Εύσημα & άδειες

Το Mus-Eq έχει άδεια MIT ή Apache-2.0, ό,τι προτιμάς. Ο player είναι το Webamp (MIT), και η ελληνική λίστα σταθμών έρχεται από το Tray-FM του Constantinos (Unlicense). Όλα τα προγράμματα τρίτων είναι στο THIRD_PARTY.md.

Άρθρα

• Mus-Eq: η μουσική μου, στον δικό μου server, 7 Νοεμβρίου 2026