Hardware requirements

Installation

Installation happens entirely from a USB stick, with a full installer built into the device itself. Drive it directly on the mini-PC's screen (mouse/keyboard/touchscreen), or from your phone via the QR code shown in the corner — both work at once, and neither needs the other to get started.

1. Download the ISO Download the latest version from the download section of the website (it is also on GitHub).
2. Write the ISO to a USB stick The simplest way is Osmium Flasher, from the download section: it downloads the image, verifies its signature and writes the stick, and it never lists your system disk. Failing that, balenaEtcher, Rufus or the dd command work just as well. Use a stick of at least 8 GB.
3. Boot the mini-PC from the stick Plug in the stick, power on the mini-PC, and pick USB boot from the boot menu (usually F11/F12/Esc depending on the motherboard). Choose Install Osmium Sound from the menu.
4. Choose the disk, right on the screen The welcome screen offers Choose disk as the main action: tap it and pick the target disk from the list shown on the mini-PC's own screen.
5. Confirm A clear warning is shown: all data on the chosen disk will be erased. Tap Erase and install to proceed.
6. Wait for it to finish Progress is shown live on screen. No internet connection is needed for this part. When it's done, the device reboots on its own.
7. Unplug the USB stick Once the mini-PC has restarted, remove the stick.

First boot and setup

After installation, the first thing the screen asks for is the network: pick your Wi-Fi and type its password, or just plug in a network cable. As soon as the device is online, the screen shows its address (for example http://192.168.1.23). Type it exactly as shown, including http://, into the browser of a phone, tablet or computer — a computer works best, because the music server's page opened at the end doesn't look great on a phone. Setup continues from there, and the screen moves on by itself when it's done: there's no button to press on the device.

Guided setup steps (in the browser)

1. Language Choose English or Italian for this setup run. It's asked once, up front — there's no way to change it again until you restart the wizard from scratch (the same as a phone's own first-run language screen).
2. Restore from backup, or start fresh If you've used Osmium Sound before and have a backup file, you can upload it here (with its passphrase, if encrypted): network, audio output, Lyrion, music sources, time zone and your account are all restored automatically and the device reboots on its own. Otherwise, choose to start fresh and continue with the steps below.
3. Update, if one is needed The device checks whether it must update before going on. If so, it downloads and applies the update, reboots, and setup picks back up right where it left off.
4. Name this device Optional: give it a name (letters, numbers, and dashes only) — it becomes its network address (e.g. "livingroom" → livingroom.local instead of hifiplayer.local) and the name you'll see in the player list. Leave it empty to keep the default. Worth setting if you'll have more than one Osmium Sound at home, since two units with the same default name get mixed up.
5. Device mode Choose between With screen, Headless, and Server-only — see Device modes for details.
6. Mouse pointer With a screen only: hide the pointer for a touchscreen, or show it if you'll use a mouse.
7. Audio output Select the detected USB DAC or HDMI output. You can change this at any time later from Settings.
8. Music server (Lyrion) Choose whether this device should be the music server (recommended for the first device in your home), or use a Lyrion server already on your network (for an additional device). A server on the network is found for you; you can also type its address or its name, such as nas.local. If this device is the server, it downloads and installs it now, showing the progress.
9. Web player look Pick how the music server's web page looks: Osmium (recommended, same style as the device) or the standard Material.
10. Music services A few short pages — streaming services (Spotify, TIDAL, Qobuz, Deezer), internet radio, information about your music, and whether to send anonymous usage statistics. Tick what you want; nothing is installed until you press Install and continue on the last page, and you can go back and forth freely.
11. Create your account Only when starting fresh: pick the username and password you'll use for web administration from now on — there's no separate account-creation step later, it's part of this same wizard.
12. Time zone Set the correct time zone for the clock, alarms, and scheduling.
13. Music sources Optional: add a network drive (NAS) and/or set up an internal disk for your music library — USB drives already mount automatically, so there's nothing to do for those. For a network drive the device looks for the computers and NAS on your network and lists their shared folders: pick one, and if it asks for a username and password a small window appears for them. An internal disk can be used as-is or formatted first (ext4 or exFAT — this erases everything on it and asks you to type the disk's name to confirm). Add as many as you like, then press Done, continue. You can always add more later from Settings.
14. Remote control Optional: "Do you want to set up a remote control?" A USB remote already works once its receiver is plugged in. For a Bluetooth one, say which remote you have: for the three known models (Amazon Fire TV, Xiaomi Mi Box S, G20S PRO) the page shows how to put it in pairing mode and the device finds and connects it by itself; any other remote is paired from a list. You can skip this and do it later from Settings → Remote control.
15. Finish setup Press "Complete setup". The device switches to the mode you chose and, if it is the music server, your browser opens its web player, ready to use.

Device modes

Osmium Sound supports three operating modes, chosen during setup and changeable at any time from Settings:

The two underlying settings are independent of each other:

Server-only = Display mode set to Headless + Player set to Off, applied together.

Web administration

Every Osmium Sound device exposes a web administration page reachable from any browser on the same network — especially useful for headless or server-only devices, but always available. The address to use is the device's IP address, visible in Settings → System info (on screen or in the companion app), the web admin session itself, or your router's device list:

The home page also has a Disk space card: a bar and a small table telling how much the system takes, how much your data uses, and how much is still free.

From Settings → Music sources → Manage files you get a file manager for the music on the device, on its internal disks, on network folders and USB drives, and for the playlists: create folders, rename, copy, cut, paste and delete, as on a computer. It is only in web administration, not on the device's screen.

Library (the link at the top of web administration, or http://<device-ip>/library, with the same account) is for putting right what the album and artist pages show:

• Tags in the files — fix an album's name, artist, year, genre, composer and the details of each track; the changes are written into the music files and the library updates by itself. Every save can be undone from History. Only folders the device can write to can be changed. FLAC, MP3, MP2, AAC and ALAC in M4A, Ogg Vorbis, Opus, Speex and FLAC in Ogg, WMA, WavPack, Monkey's Audio, Musepack, OptimFROG, TAK, True Audio, DSF, DFF, WAV and AIFF can all be written; a track cut out of a single file by a cue sheet, or a raw AAC stream, is shown but not changed.
• Online credits — correct a misspelled name, link a person to the right artist, take someone off a credit or hide a whole line, change a role or an instrument, add a missing credit, or choose the right edition of the album. These corrections stay on the device, leave the music files untouched and are included in backups; Back to MusicBrainz undoes them. The album page then says the credits were corrected by hand.
• Artists — choose which MusicBrainz artist a name really is, show a different name or hide the biography.

Android companion app

Control Osmium Sound from your phone: browse the library, control playback and the queue, adjust volume. Free on Google Play; also distributed as a signed APK or via the project's self-hosted F-Droid repository.

1. Install the app Get it from Google Play. If you would rather not use Google Play, download the APK from the project's Releases or add the F-Droid repository — details on the official website.
2. Pair the device From the device's screen (if in "with screen" mode), go to Settings and show the pairing QR code; or, for a headless/server-only device, generate the QR from web administration. Scan it from the app.
3. Use the app Once paired, the app talks directly to Lyrion and the device's API on the local network.

The device settings are grouped under Settings → Osmium Sound, with the same sections as web administration: audio output, music sources, services, Lyrion Music Server, playback and VU meters (including the looks to download), display, time zone, updates, iPhone/iPad, backup & restore, and system. A few things stay in web administration only, on purpose: network, the SSH login, the web account, factory reset and the debug tools. The Now Playing animations are chosen on the device's screen or in web administration, not in the app. With an older device, sections it doesn't support yet simply don't appear.

Once paired, a power icon in the app's top bar turns the Osmium Sound device off, after asking for confirmation.

The first time you open the app it asks for your language, then what you are connecting to. Choose Osmium Sound to scan the pairing code and get the device settings listed above, or another Lyrion server to type in an address and port instead — in that case the device settings are not shown, because there is no Osmium device behind them. If the connection doesn't work, the "Trouble connecting?" guide on that screen walks you through the usual causes.

Listening on the phone itself

The phone can also be one of the players in the house. It appears in the player list with its own name, next to the Osmium device and any other player, and you pick it the same way. The music then comes out of the phone's speaker or headphones, while everything else — the library, the queue, the volume — keeps working as usual.

In Settings, under "This phone as a player", you can turn it off, rename it, and choose how good the sound should be, separately for Wi-Fi and mobile data. The best quality sounds better and moves from one track to the next with no gap; the lighter ones use much less data.

On iPhone and iPad

There is no Osmium companion app for Apple devices. We suggest LyrPlay, a third-party app by Eric Miller: it connects to the Lyrion Music Server running on your Osmium device, gives you the Material interface to drive playback, and can also turn the iPhone or iPad itself into another player on the network. It is free, with an optional paid icon pack. It is not our app, we have no connection with its author and we cannot support it — we are simply recommending something that works well with Osmium Sound.

LyrPlay on the App Store

Daily use

• Now Playing — the expanded view shows the analog VU meters (see VU meters) — or, with them off, an animation (see Animations) — and a status plate: the kind of audio playing (Hi-Res, PCM, DSD) and whether BitPerfect or ReplayGain is on. Tap BitPerfect or ReplayGain to jump straight to the setting behind it. Next to the clock, one button shows the VU meters (or the animation) at full screen with the title, artist and progress, and two more open a chooser of VU meter looks and of animations, each with a preview: picking a look turns the meters on, picking an animation turns them off. The gear at the right end of Now Playing's top buttons goes straight to Settings.
• Choosing the player — tap the player name in the bar at the bottom (or the speaker button in Now Playing) to see the other players on the same music server, and pick one to control it from this screen: what's playing, the queue, the volume. The name turns gold as a reminder. Settings that belong to this device are hidden meanwhile, with a Back to this device button; after a restart the screen is always back on its own player.
• Power button — the power icon at the right end of the top bar restarts or shuts down the device.
• Network — the icon between the Osmium Sound mark and the power button shows the connection: Wi-Fi or cable when the internet answers, a gold dot when only the home network does, a crossed-out shape when nothing answers; tap it for an explanation in words. In Settings → Network Configuration the Wi-Fi networks the device knows are marked Saved and join without a password, a network broadcast on both 2.4 and 5 GHz shows its band, and Saved Wi-Fi networks lists them all, the one in use first, each with a Forget button (forgetting the one in use disconnects now). Check the network, in Settings → System Information and Settings → Updates, tests the connection step by step — cable or Wi-Fi, router, internet, name lookup, clock, update server — and tells you where it stops.
• Music / Radio / Apps — Lyrion Music Server's interface: local library, internet radio, and streaming services (Deezer, Qobuz, TIDAL, Spotify and others) via Lyrion plugins. The Music tab opens on a search box that looks through the whole library (artists, albums, tracks) and on tiles for artists, albums, genres, years, composers, new music, folders, playlists and favourites. Albums can be shown as a grid or as Cover Flow, a row of covers to leaf through with a finger or the mouse wheel: switch with the button at the top of the album list, or in Settings → Library → Album view.
• Album and artist pages — tap an album to open its page: cover, year, length and format, buttons to play, shuffle or queue it, the tracks (tap one to start the album from there) and the credits written in your music files. Tap an artist — in the library, on an album page, or under the title in Now Playing — for their page, with their albums grouped by what they did on them: as the artist, with a band or orchestra, as composer, as conductor, appearing on someone else's record. With an internet connection the pages also show who played what and on which instrument, who produced and recorded the album and where, when it first came out, the members of a band and a short biography, taken from MusicBrainz and Wikipedia. If an album page shows a different record from yours, tap Wrong album? Choose the edition at the bottom.
• Favourites and playlists — the heart in Now Playing adds or removes what is playing from the favourites; press and hold any row (a track, an album, a radio station, a playlist — also inside the apps, the radio and Favourites) for more: add to the queue, play next, add to favourites. In Favourites you can rename, reorder and remove; playlists can be renamed, deleted and trimmed of a track.
• Refreshing the library — Settings → Lyrion Music Server shows how many albums, artists and tracks the server knows, when it last scanned, and a Refresh the library button with progress (also on the web administration Dashboard). Sources you add or change are scanned on their own; use this after moving music around by hand. In the same section, Album and artist information turns the online look-ups for the album and artist pages on or off, can prepare the whole library slowly in the background so the pages open complete, and clears what has been saved. What has been downloaded stays until you clear it, and Where to keep it lets you put it on a disk of yours instead of on the player: what is already there moves with the choice, nothing is downloaded again. If that disk is not connected, the player goes back to using its own storage until you plug it in. To find the information, the device sends the names of your albums and artists to MusicBrainz and Wikipedia.
• CD — insert a disc and rip it to FLAC (or WAV) with automatic tags and cover art (MusicBrainz), straight into your library, an adopted USB drive, or a writable network share, as Artist/Album with a ripping log next to it. A ripped album is recognised right away on its album page. Settings → CD ripping (on screen and in the web admin) holds the default folder, chosen with the same folder browser as Music sources, the format, how many times a track is re-read until two reads agree, pre-emphasis, ReplayGain, the log, eject after the rip, automatic start, and the drive’s speed and read offset (Calibrate looks it up in AccurateRip’s list). Eject and Cancel are always at hand, also after a failed rip, for drives without a button.
• Discover — endless mixes by track, album, or artist, with a genre filter and saveable presets, plus "keep playing similar music", related artists, and bios, right on the touchscreen.
• Settings → Playback — track transition, ReplayGain, the now-playing auto-expand timeout, and a fixed-volume-100% (BitPerfect) toggle that turns off Lyrion's own digital volume control and greys out the volume slider.
• Settings — system and network info, audio output, Bluetooth speakers, remote control, music sources, CD ripping, Lyrion Music Server, VU meters, animations, alarm clock, interface motion, updates, companion app pairing, backup, licenses and credits, factory reset.
• Guided tour and motion — after setup the screen shows a short guided tour once; Show the guided tour of the screen again in Settings → System Information replays it. Settings → Interface motion sets how much the interface moves: Full (buttons give way under a finger, panels slide in), Reduced (the same, twice as quick) or None.

VU meters

Now Playing can show a pair of analog VU meters whose needles move with the music. Everything about them is in Settings → VU meters — on the screen, in web administration, or in the companion app:

• On or off — turn them off if you prefer a cleaner screen.
• Look — pick one of the styles from its preview: six come with the device (Classic, Modulometer, Amber, Ice Blue, Exposed, Panoramic).
• More to download — in the same section you'll find further looks to download. A new one is only offered, never installed on its own; a gold dot tells you something new is there. Once downloaded, a look keeps itself up to date, stays after system updates, and can be removed at any time (if it was in use, the device goes back to Classic).

Animations

With the VU meters turned off, Now Playing can show an animation in their place. Choose it in Settings → Animations — on the screen or in web administration, where each one has a still preview — or from the animations button next to the clock:

• None — the song lyrics take the place of the VU meters.
• Top-loading CD — a disc goes into a player from above, then spins.
• CD player — a late-80s front loader: the drawer comes out with the disc, the fluorescent display shows the track and the time, and its keys work — OPEN, the track numbers, REPEAT, RANDOM, skip and search, play, pause, stop and POWER.
• Vinyl — the tonearm lowers onto a record, then the record spins; START/STOP works.
• Cassette — a tape goes into a deck, then runs from one reel to the other; the keys work, REW and FF wind while held, and the fader sets the volume. The label shows the track playing.

It moves only while music is playing: pause, and it slows down and stops. When a new album starts, the disc or tape comes out and goes back in. With an internet radio the cassette label and the CD display show the station and the song. The full-screen button next to the clock shows the animation large. The button in Now Playing that brings up the song lyrics switches between the animation and the lyrics.

More animations to download — in the same section you'll find further animations, from Osmium Sound's own signed list, like the VU meter looks: once downloaded, an animation keeps itself up to date and can be removed at any time.

Remote control

A remote control can drive the whole screen: the arrows move a gold ring from item to item, OK presses it, Back goes back, and the menu key works like holding a finger on an item. Everything is in Settings → Remote control, on the screen and in web administration.

• USB remotes — plug in the receiver: it works straight away.
• Bluetooth remotes — press Add a remote and say which one you have. Three models are known: Amazon Fire TV (3rd generation — hold Home until the light blinks), Xiaomi Mi Box S (hold ⋮⋮⋮ and ○ together for 7–8 seconds) and G20S PRO (hold OK and Back for 5–7 seconds). Put it in pairing mode and leave it near the device: it is found and connected by itself. While a device with a screen has no remote, it also keeps an ear open for these three and pairs one on its own. Any other remote is paired by searching and tapping it in the list.
• Key map — a known model shows a drawing of what each key does the first time it turns up; you can see it again from Settings → Remote control. After the first setup, Try the remote walks you through the main keys once.
• Try and assign the keys — press a key to see what it sends, and give it another job: full screen, next VU meter look, next animation, open favourites, search, restart the touchscreen, restart or shut down…
• Power — the remote's power key never switches the device off by itself: it opens the Restart / Shut down menu, with the ring on Cancel. The sleep key rests the screen.

A keyboard's or a sound card's own play and volume keys keep working as keys and are not taken for a remote. In web administration you can download a remote control card with what the device sees, to send to support.

Music sources

Osmium Sound reads your music library from one or more sources, configurable from Settings (or during initial setup):

• Network folder — a NAS or a shared folder on another computer. You don't need to know its address: the device looks for the computers and NAS on your network, lists their shared folders, and asks for a username and password in a small window only if the folder needs them. If it can't connect, it tells you why in plain words (the technical details stay one tap away). You can still type everything in by hand. A folder is added writable, unless the server only allows reading; each one can be toggled between read-only and writable at any time — handy if you also want to rip CDs onto it.
• USB disk — a USB disk plugged into the device, "adopted" (shared on the network, read/write). An adopted drive auto-remounts on its own if you unplug and reconnect it, or reconnect it after a reboot.
• Internal disk — a second disk inside the device, dedicated to music.
• A folder on the device itself — music copied straight onto the device's own disk. It can be shared on the network so you can copy music into it from a computer.

After adding or editing a source, the library is updated on its own. In web administration, Music sources is a menu — active sources, add a source, playlist folder, shared folders, manage files — where each screen has a way back.

Under Playlist folder you choose where playlists are saved; share it on the network to copy playlists onto the device. Playlists made on Windows are fixed automatically so they play here too.

Streaming & Lyrion plugins

Streaming services (Deezer, Qobuz, TIDAL, Spotify and others) and extra features (UPnP/DLNA, AirPlay, radio) are Lyrion Music Server plugins, not part of the Osmium Sound app itself. The most common ones can already be ticked during setup (the "Music services" step); for the others, or to add one later:

1. Open Lyrion's web UI http://<device-ip>:9000 — see Web administration for how to find the IP address.
2. Go to Settings → Plugins Find and enable the plugin for the service you want.
3. Log in with your credentials Follow the plugin's instructions to log into the service.
4. Go back to the Osmium Sound interface The new service shows up on its own in the Radio/Apps tabs — no app update needed.

External Lyrion server

Each Osmium Sound device plays through its own Lyrion Music Server by default. From Settings → Lyrion Music Server you can switch between Internal and External (on my network): the second one uses a Lyrion server already running on another device, found for you by a search of your network — you can also type its IP address or its name, such as nas.local. A name that can't be found is refused before anything changes. Switching restarts the device. The same section holds the player name, the Lyrion version and the web player look.

Playing several players in sync (multiroom) is a native Lyrion Music Server feature, managed from Lyrion's own interface — Osmium Sound doesn't provide a separate multiroom feature of its own. Give each device a name so they're easy to tell apart there. From the device's screen you can also control any other player on the same server — see Daily use.

Bluetooth speakers

Osmium Sound can play to Bluetooth speakers and headphones. Everything is in Settings → Bluetooth speakers, on the screen and in web administration:

• Bluetooth — off until you need it: while it is off the Bluetooth radio stays powered down. Without a Bluetooth adapter the section says so; a small USB one is enough.
• Search — put the speaker in pairing mode and search: it shows up in about ten seconds, tap it to add it.
• Each speaker is a player — a speaker you add appears in the player list, in the companion app and in Lyrion as a player of its own, with its own queue and volume: play something different on it, or group it with the other players. Name of the player changes the name it shows under.
• Reconnect on its own — the device connects to the speaker again as soon as it is switched back on. Connect, Disconnect and Forget are next to each speaker.

Bluetooth is for sending music out: the device does not receive music from a phone over Bluetooth. The pairings are part of an encrypted backup, and a factory reset forgets them.

Backup & restore

From Settings you can create a full backup of the device's configuration: audio output, the music source list, Lyrion preferences and playlists, the album and artist information downloaded from the web and the corrections you made to it, Wi-Fi network profiles, account and pairing tokens. Sensitive data (Wi-Fi networks, account) only enters the backup if you choose to protect it with a passphrase.

• Manual backup — Settings → Backup → Create backup now, with or without a passphrase.
• Scheduled backup — enable it in Settings; runs a weekly backup automatically (non-sensitive data only, since there's nobody to ask for a passphrase).
• Restore — from Settings on an already-configured device, or directly during first-boot setup (see First boot and setup) to quickly bring a replaced or reset device back up.

OTA updates

Osmium Sound and Lyrion Music Server update over the internet (OTA, over-the-air) from Settings → Updates — on the screen, in web administration or in the companion app — with no need to ever reflash the USB stick after the initial install. Press Check for updates: within a minute it tells you that an update is available, that you're up to date, or that it couldn't check (usually a network problem — Check the network, highlighted right there, finds where the connection stops).

The whole system arrives as a single, digitally signed package: the device refuses anything that isn't signed correctly, even if someone managed to tamper with the download. The device keeps two copies of the system side by side. An update is written into the copy that isn't in use, while the device carries on working, with the progress shown live; the restart at the end switches over to it. If the new version doesn't start properly, the device goes back to the previous one on its own, within about ten minutes. Your settings, your music and everything you downloaded are kept apart from the system, so an update never touches them.

Each device can pick a release channel in Settings → Updates:

SSH & advanced access

SSH access is off by default. It can be turned on from Settings (on-screen or from web administration → Services) for advanced maintenance or debugging. Right under the switch you choose the username and password to log in with; the panel then shows the exact ssh command to use.

Installing extra programs

The system itself can't be modified, but over SSH the usual sudo apt install <package> still works: the extra program is kept apart from the system, and sudo apt remove takes it away again. After a system update the device rebuilds your extra programs for the new version by itself when it starts (it needs the internet for that). A package that would replace part of the system, or needs newer system components than the device has, is refused with an explanation. The system itself is not updated with apt upgrade but from Settings → Updates.

To try a VU meter look or an animation before it is published, sudo hifi-pack-install FILE.vupak (or .animpak) installs it with the same checks as the online lists, except the signature; --list shows what is installed, --remove vu|anim ID takes it away. An animation is a small program the screen runs: install only files you trust.

Remote access (Tailscale)

Web administration also offers optional remote access via Tailscale, so you can reach the device from outside your home network — into your own Tailscale account, not a vendor-run service.

1. Install Tailscale From web administration → Settings → Tailscale, install it on the device if it isn't already present.
2. Enable it Turning it on opens a one-time login URL — open it in a browser and sign in to your own Tailscale account (or create one) to authorize the device onto your tailnet.
3. Connect from anywhere Once connected, the device's Tailscale IP and connection details (including DERP relay region/latency) are shown in the same Settings section. Reach web administration through that address from any other device on your tailnet.

Factory reset

Factory reset erases every setting, the web administration account, configured sources, backups kept on the device, downloaded VU meter looks and animations and the Bluetooth pairings, then reboots the device straight back into the setup described in First boot and setup — as if it had just been installed. Music copied onto the device itself is kept.

Available from:

• On-screen, in Settings → System Controls → Factory reset (if the device is in "with screen" mode).
• Web administration, by entering the administrator account's password.

Troubleshooting

Resources & links

• README.md — project overview, features, and specs
• QUICKSTART.md / GUIDA-RAPIDA.md — quick-start guide in English/Italian
• ARCHITECTURE.md — technical/architectural documentation for developers
• SECURITY.md — security policy
• GitHub repository — source code, issues, releases
• Official website — downloads, companion app
• [email protected] — support

Requisiti hardware

Installazione

L'installazione avviene interamente da chiavetta USB, con un installer completo integrato nel dispositivo stesso. Guidala direttamente sullo schermo del mini-PC (mouse/tastiera/touchscreen), oppure dal telefono tramite il QR code mostrato nell'angolo — funzionano entrambi contemporaneamente, e nessuno dei due richiede l'altro per iniziare.

1. Scarica la ISO Scarica l'ultima versione dalla sezione download del sito (è anche su GitHub).
2. Scrivi la ISO su una chiavetta USB Il modo più semplice è Osmium Flasher, dalla sezione download: scarica l'immagine, ne verifica la firma e scrive la chiavetta, senza mai elencare il disco di sistema. In alternativa vanno bene balenaEtcher, Rufus o il comando dd. Serve una chiavetta da almeno 8 GB.
3. Avvia il mini-PC dalla chiavetta Collega la chiavetta, accendi il mini-PC e seleziona l'avvio da USB dal menu di boot (di solito F11/F12/Esc a seconda della scheda madre). Scegli Install Osmium Sound dal menu.
4. Scegli il disco, direttamente sullo schermo La schermata di benvenuto propone Choose disk come azione principale: toccala e scegli il disco di destinazione dall'elenco mostrato sullo schermo del mini-PC.
5. Conferma Viene mostrato un avviso chiaro: tutti i dati sul disco scelto verranno cancellati. Tocca Erase and install per procedere.
6. Attendi il completamento L'avanzamento è mostrato in tempo reale a schermo. Per questa parte non serve la connessione a internet. Al termine, il dispositivo si riavvia automaticamente.
7. Scollega la chiavetta USB Quando il mini-PC si è riavviato, rimuovi la chiavetta.

Primo avvio e configurazione

Dopo l'installazione, la prima cosa che lo schermo chiede è la rete: scegli il tuo Wi-Fi e scrivi la password, oppure collega semplicemente un cavo di rete. Appena il dispositivo è in rete, lo schermo mostra il suo indirizzo (per esempio http://192.168.1.23). Scrivilo esattamente come appare, http:// compreso, nel browser di un telefono, un tablet o un computer — meglio un computer, perché la pagina del server musicale che si apre alla fine non si vede benissimo su un telefono. La configurazione prosegue da lì, e lo schermo va avanti da solo quando hai finito: sull'apparecchio non c'è nessun pulsante da premere.

Passaggi della configurazione guidata (nel browser)

1. Lingua Scegli Inglese o Italiano per questa configurazione. Viene chiesto una sola volta, all'inizio — non c'è modo di cambiarla di nuovo finché non riavvii la procedura guidata da zero (come la schermata di scelta della lingua al primo avvio di un telefono).
2. Ripristina da backup, oppure inizia da zero Se hai già usato Osmium Sound in passato e hai un file di backup, puoi caricarlo qui (con la relativa passphrase, se cifrato): rete, uscita audio, Lyrion, sorgenti musicali, fuso orario e account vengono ripristinati automaticamente e il dispositivo si riavvia da solo. Altrimenti, scegli di iniziare da zero e prosegui con i passaggi seguenti.
3. Aggiornamento, se serve Il dispositivo controlla se deve aggiornarsi prima di proseguire. In quel caso scarica e applica l'aggiornamento, si riavvia, e la configurazione riprende esattamente da dove si era fermata.
4. Dai un nome a questo dispositivo Facoltativo: assegnagli un nome (solo lettere, numeri e trattini) — diventa il suo indirizzo di rete (es. "salotto" → salotto.local invece di hifiplayer.local) e il nome con cui compare nell'elenco dei player. Lascia vuoto per mantenere quello predefinito. Vale la pena impostarlo se avrai più di un Osmium Sound in casa, perché due unità con lo stesso nome predefinito si confondono.
5. Modalità del dispositivo Scegli tra Con schermo, Headless e Solo server — vedi la sezione Modalità del dispositivo per i dettagli.
6. Puntatore del mouse Solo con schermo: nascondi il puntatore per un touchscreen, oppure mostralo se userai un mouse.
7. Uscita audio Seleziona il DAC USB o l'uscita HDMI rilevata. Si può cambiare in ogni momento più avanti dalle Impostazioni.
8. Server musicale (Lyrion) Scegli se il server musicale deve essere questo dispositivo (impostazione consigliata per il primo dispositivo in casa), oppure usare un server Lyrion già presente sulla rete (per un dispositivo aggiuntivo). Un server in rete viene trovato da solo; puoi anche scriverne l'indirizzo o il nome, per esempio nas.local. Se il server è questo dispositivo, lo scarica e lo installa adesso, mostrando l'avanzamento.
9. Aspetto del player web Scegli l'aspetto della pagina web del server musicale: Osmium (consigliato, con lo stesso stile dell'apparecchio) oppure il classico Material.
10. Servizi musicali Qualche pagina breve — servizi di streaming (Spotify, TIDAL, Qobuz, Deezer), radio via internet, informazioni sulla musica, e se inviare statistiche d'uso anonime. Spunta quello che ti interessa; non viene installato nulla finché non premi Installa e continua nell'ultima pagina, e puoi andare avanti e indietro liberamente.
11. Crea il tuo account Solo se inizi da zero: scegli il nome utente e la password che userai da ora in poi per l'amministrazione web — non c'è un passaggio separato più avanti, fa parte di questa stessa procedura guidata.
12. Fuso orario Imposta il fuso orario corretto per orologio, allarmi e programmazioni.
13. Sorgenti musicali Facoltativo: aggiungi un disco di rete (NAS) e/o configura un disco interno per la tua libreria musicale — le unità USB si montano già automaticamente, quindi per quelle non serve fare nulla. Per un disco di rete il dispositivo cerca i computer e i NAS della tua rete e ne elenca le cartelle condivise: scegline una, e se chiede nome utente e password compare una piccola finestra dove scriverli. Un disco interno può essere usato così com'è oppure formattato prima (ext4 o exFAT — questo cancella tutto ciò che contiene e chiede di digitare il nome del disco per confermare). Aggiungine quante vuoi, poi premi Fatto, continua. Puoi sempre aggiungerne altre in seguito dalle Impostazioni.
14. Telecomando Facoltativo: «Vuoi configurare un telecomando?». Un telecomando USB funziona già appena infili la sua chiavetta. Per uno Bluetooth, di' quale telecomando hai: per i tre modelli conosciuti (Amazon Fire TV, Xiaomi Mi Box S, G20S PRO) la pagina spiega come metterlo in accoppiamento e l'apparecchio lo trova e lo collega da solo; ogni altro telecomando si accoppia da un elenco. Puoi saltarlo e farlo più avanti da Impostazioni → Telecomando.
15. Completa il setup Premi "Completa setup". Il dispositivo passa alla modalità scelta e, se il server musicale è lui, il browser apre il suo player web, pronto all'uso.

Modalità del dispositivo

Osmium Sound supporta tre modalità operative, scelte durante il setup e modificabili in ogni momento dalle Impostazioni:

Le due impostazioni sono indipendenti tra loro:

Solo server = Modalità schermo su Headless + Player su Spento, applicati insieme.

Amministrazione web

Ogni dispositivo Osmium Sound espone una pagina di amministrazione web raggiungibile da qualsiasi browser sulla stessa rete, utile in particolare per i dispositivi in modalità headless o solo server, ma disponibile sempre. L'indirizzo da usare è l'indirizzo IP del dispositivo, visibile in Impostazioni → Info di sistema (a schermo o nell'app companion), nella sessione di amministrazione web stessa, oppure nell'elenco dispositivi del router:

La pagina iniziale ha anche un riquadro Spazio su disco: una barra e una piccola tabella che dicono quanto occupa il sistema, quanto i tuoi dati e quanto spazio resta libero.

Da Impostazioni → Sorgenti musicali → Gestisci i file trovi un gestore di file per la musica sull'apparecchio, sui dischi interni, nelle cartelle di rete e sulle chiavette USB, e per le playlist: crea cartelle, rinomina, copia, taglia, incolla ed elimina, come su un computer. C'è solo nell'amministrazione web, non sullo schermo dell'apparecchio.

Libreria (il collegamento in alto nell'amministrazione web, oppure http://<ip-dispositivo>/library, con lo stesso account) serve a sistemare quello che mostrano le pagine di album e artisti:

• Tag nei file — correggi nome dell'album, artista, anno, genere, compositore e i dettagli di ogni brano; le modifiche vengono scritte nei file musicali e la libreria si aggiorna da sola. Ogni salvataggio si può annullare dalla Cronologia. Si possono modificare solo le cartelle in cui l'apparecchio può scrivere. Si scrivono FLAC, MP3, MP2, AAC e ALAC in M4A, Ogg Vorbis, Opus, Speex e FLAC in Ogg, WMA, WavPack, Monkey's Audio, Musepack, OptimFROG, TAK, True Audio, DSF, DFF, WAV e AIFF; un brano ritagliato da un unico file con un cue sheet, o un flusso AAC grezzo, si vede ma non si modifica.
• Crediti dal web — correggi un nome scritto male, collega una persona all'artista giusto, togli qualcuno da un credito o nascondi una riga intera, cambia un ruolo o uno strumento, aggiungi un credito mancante, oppure scegli l'edizione giusta dell'album. Queste correzioni restano sull'apparecchio, non toccano i file musicali ed entrano nei backup; Torna a MusicBrainz le annulla. La pagina dell'album indica poi che i crediti sono stati corretti a mano.
• Artisti — scegli quale artista di MusicBrainz corrisponde davvero a un nome, mostra un nome diverso o nascondi la biografia.

App companion Android

Controlla Osmium Sound dal telefono: sfoglia la libreria, gestisci riproduzione e coda, regola il volume. Gratuita su Google Play; è distribuita anche come APK firmato oppure tramite il repository F-Droid self-hosted del progetto.

1. Installa l'app Prendila da Google Play. Se preferisci non usare Google Play, scarica l'APK dalle Releases del progetto oppure aggiungi il repository F-Droid — dettagli sul sito ufficiale.
2. Abbina il dispositivo Dallo schermo del dispositivo (se in modalità "con schermo") vai su Impostazioni e mostra il QR code di abbinamento; oppure, per un dispositivo headless/solo server, genera il QR dall'amministrazione web. Scansionalo dall'app.
3. Usa l'app Una volta abbinata, l'app parla direttamente con Lyrion e con l'API del dispositivo sulla rete locale.

Le impostazioni del dispositivo sono raccolte in Impostazioni → Osmium Sound, con le stesse sezioni dell'amministrazione web: uscita audio, sorgenti musicali, servizi, Lyrion Music Server, riproduzione e VU meter (compresi gli aspetti da scaricare), schermo, fuso orario, aggiornamenti, iPhone/iPad, backup e ripristino, sistema. Alcune cose restano di proposito solo nell'amministrazione web: rete, accesso SSH, account web, reset di fabbrica e strumenti di debug. Le animazioni di Now Playing si scelgono sullo schermo dell'apparecchio o nell'amministrazione web, non nell'app. Con un apparecchio più vecchio, le sezioni che non supporta ancora semplicemente non compaiono.

Una volta abbinata, l'icona di spegnimento nella barra in alto dell'app spegne l'apparecchio Osmium Sound, dopo averti chiesto conferma.

La prima volta che apri l'app ti chiede la lingua, poi a che cosa ti stai collegando. Scegli Osmium Sound per inquadrare il codice di abbinamento e avere le impostazioni del dispositivo elencate qui sopra, oppure un altro server Lyrion per scrivere a mano indirizzo e porta: in quel caso le impostazioni del dispositivo non compaiono, perché dietro non c'è un apparecchio Osmium. Se il collegamento non riesce, la guida "Problemi con il collegamento?" in quella schermata ti accompagna tra le cause più comuni.

Ascoltare sul telefono

Il telefono può anche essere uno dei lettori di casa. Compare nell'elenco dei lettori con un nome suo, accanto all'apparecchio Osmium e a tutti gli altri, e lo scegli allo stesso modo. La musica esce allora dall'altoparlante o dalle cuffie del telefono, mentre tutto il resto — libreria, coda, volume — continua a funzionare come sempre.

Nelle impostazioni, sotto "Questo telefono come lettore", puoi disattivarlo, cambiargli nome e scegliere quanto deve essere buono il suono, separatamente per Wi-Fi e rete mobile. La qualità migliore suona meglio e passa da un brano al successivo senza stacchi; quelle più leggere consumano molti meno dati.

Su iPhone e iPad

Per i dispositivi Apple non esiste un'app companion di Osmium. Suggeriamo LyrPlay, un'app di terze parti di Eric Miller: si collega al Lyrion Music Server che gira sul dispositivo Osmium, mette a disposizione l'interfaccia Material per comandare la riproduzione, e può anche trasformare l'iPhone o l'iPad in un ulteriore lettore sulla rete. È gratuita, con un pacchetto di icone opzionale a pagamento. Non è un'app nostra, non abbiamo alcun rapporto con il suo autore e non possiamo fornirne assistenza: ci limitiamo a segnalare qualcosa che funziona bene con Osmium Sound.

LyrPlay sull'App Store

Uso quotidiano

• Now Playing — la vista espansa mostra i VU meter analogici (vedi VU meter) — oppure, se sono spenti, un'animazione (vedi Animazioni) — e una targa di stato: il tipo di audio in riproduzione (Hi-Res, PCM, DSD) e se BitPerfect o ReplayGain sono attivi. Tocca BitPerfect o ReplayGain per andare dritto all'impostazione corrispondente. Accanto all'orologio, un pulsante mostra i VU meter (o l'animazione) a schermo intero con titolo, artista e avanzamento, e altri due aprono la scelta degli aspetti dei VU meter e delle animazioni, ognuno con l'anteprima: scegliere un aspetto accende i VU meter, scegliere un'animazione li spegne. L'ingranaggio all'estremità destra dei pulsanti in alto di Now Playing porta dritto alle Impostazioni.
• Scegliere il player — tocca il nome del player nella barra in basso (o il pulsante con l'altoparlante in Now Playing) per vedere gli altri player dello stesso server musicale, e scegline uno per comandarlo da questo schermo: cosa suona, la coda, il volume. Il nome diventa dorato come promemoria. Nel frattempo le impostazioni che riguardano questo apparecchio sono nascoste, con un pulsante Torna a questo apparecchio; dopo un riavvio lo schermo torna sempre al proprio player.
• Pulsante di spegnimento — l'icona di accensione all'estremità destra della barra in alto riavvia o spegne l'apparecchio.
• Rete — l'icona fra il marchio Osmium Sound e il pulsante di spegnimento mostra la connessione: Wi-Fi o cavo quando internet risponde, un punto dorato quando risponde solo la rete di casa, una forma barrata quando non risponde niente; toccala per una spiegazione a parole. In Impostazioni → Configurazione Rete le reti Wi-Fi che l'apparecchio conosce sono segnate Salvata e si collegano senza password, una rete trasmessa sia a 2,4 sia a 5 GHz mostra la sua banda, e Reti Wi-Fi salvate le elenca tutte, quella in uso per prima, ognuna con un pulsante Dimentica (dimenticare quella in uso scollega subito). Controlla la rete, in Impostazioni → Informazioni Sistema e Impostazioni → Aggiornamenti, prova la connessione un passo alla volta — cavo o Wi-Fi, router, internet, risoluzione dei nomi, orologio, server degli aggiornamenti — e ti dice dove si ferma.
• Musica / Radio / App — l'interfaccia di Lyrion Music Server: libreria locale, radio internet e servizi di streaming (Deezer, Qobuz, TIDAL, Spotify e altri) tramite i plugin di Lyrion. La scheda Musica si apre su una casella di ricerca che cerca in tutta la libreria (artisti, album, brani) e sulle tessere artisti, album, generi, anni, compositori, novità, cartelle, playlist e preferiti. Gli album si possono vedere a griglia o come Cover Flow, una fila di copertine da sfogliare col dito o con la rotella del mouse: si cambia col pulsante in alto nell'elenco degli album, o in Impostazioni → Libreria → Vista degli album.
• Pagine di album e artisti — tocca un album per aprire la sua pagina: copertina, anno, durata e formato, i pulsanti per riprodurlo, in ordine casuale o in coda, i brani (toccane uno per far partire l'album da lì) e i crediti scritti nei tuoi file musicali. Tocca un artista — nella libreria, in una pagina album o sotto il titolo in Now Playing — per la sua pagina, con gli album raggruppati secondo il suo ruolo: come artista, con un gruppo o un'orchestra, come compositore, come direttore, ospite nel disco di qualcun altro. Con la connessione a Internet le pagine mostrano anche chi ha suonato cosa e con quale strumento, chi ha prodotto e registrato l'album e dove, quando è uscito la prima volta, i membri di un gruppo e una breve biografia, presi da MusicBrainz e Wikipedia. Se una pagina album mostra un disco diverso dal tuo, tocca Non è questo disco? Scegli l'edizione in fondo.
• Preferiti e playlist — il cuore in Now Playing aggiunge o toglie dai preferiti quello che sta suonando; tieni premuta una riga qualsiasi (un brano, un album, una stazione radio, una playlist — anche dentro le app, la radio e i Preferiti) per fare di più: aggiungi alla coda, riproduci dopo, aggiungi ai preferiti. Nei Preferiti puoi rinominare, riordinare e togliere; le playlist si possono rinominare, eliminare e alleggerire di un brano.
• Aggiornare la libreria — Impostazioni → Lyrion Music Server mostra quanti album, artisti e brani conosce il server, quando ha fatto l'ultima scansione, e un pulsante Aggiorna la libreria con l'avanzamento (c'è anche nella Dashboard dell'amministrazione web). Le sorgenti che aggiungi o cambi vengono scansionate da sole; usalo dopo aver spostato musica a mano. Nella stessa sezione, Informazioni su album e artisti accende o spegne le ricerche online per le pagine di album e artisti, può preparare con calma tutta la libreria in sottofondo così le pagine si aprono già complete, e cancella quello che è stato salvato. Quello che hai scaricato resta finché non lo cancelli tu, e Dove tenerle ti permette di metterlo su un disco tuo invece che sul lettore: quello che c'è già si sposta con la scelta, non si riscarica niente. Se quel disco non è collegato, il lettore torna a usare la propria memoria finché non lo ricolleghi. Per trovare le informazioni, l'apparecchio invia a MusicBrainz e Wikipedia i nomi dei tuoi album e artisti.
• CD — inserisci un disco e rippalo in FLAC (o WAV) con tag e copertina automatici (MusicBrainz), direttamente nella libreria, su un disco USB adottato o su una condivisione di rete scrivibile, come Artista/Album con accanto il log del rip. Un album rippato viene riconosciuto subito nella sua pagina. Impostazioni → Rip dei CD (a schermo e nell’amministrazione web) tiene la cartella predefinita, scelta con lo stesso navigatore delle Sorgenti musicali, il formato, quante volte una traccia viene riletta finché due letture coincidono, la pre-enfasi, il ReplayGain, il log, l’espulsione a fine rip, l’avvio automatico, e velocità e offset di lettura del lettore (Calibra lo cerca nell’elenco di AccurateRip). Espelli e Annulla sono sempre a portata di mano, anche dopo un rip fallito, per i lettori senza tasto.
• Discover — mix infiniti per brano, album o artista, con filtro per genere e preset salvabili, oltre a "continua ad ascoltare musica simile", artisti correlati e biografie direttamente a schermo.
• Impostazioni → Riproduzione — transizione tra i brani, ReplayGain, timeout di espansione automatica del now playing, e un interruttore volume fisso al 100% (BitPerfect) che disattiva il controllo volume digitale di Lyrion e disabilita visivamente lo slider del volume.
• Impostazioni — info di sistema e rete, uscita audio, altoparlanti Bluetooth, telecomando, sorgenti musicali, rip dei CD, Lyrion Music Server, VU meter, animazioni, sveglia, movimento dell'interfaccia, aggiornamenti, abbinamento app companion, backup, licenze e crediti, reset di fabbrica.
• Guida e movimento — dopo la configurazione lo schermo mostra una volta una breve guida; Rivedi la guida dello schermo in Impostazioni → Informazioni Sistema la ripropone. Impostazioni → Movimento dell'interfaccia decide quanto si muove l'interfaccia: Completo (i pulsanti cedono sotto il dito, i pannelli scorrono), Ridotto (gli stessi movimenti, al doppio della velocità) o Nessuno.

VU meter

Now Playing può mostrare una coppia di VU meter analogici con gli aghi che si muovono con la musica. Tutto quello che li riguarda è in Impostazioni → VU meter — sullo schermo, nell'amministrazione web o nell'app companion:

• Accesi o spenti — spegnili se preferisci uno schermo più pulito.
• Aspetto — scegli uno degli stili dalla sua anteprima: sei sono già nell'apparecchio (Classic, Modulometer, Amber, Ice Blue, Exposed, Panoramic).
• Altri da scaricare — nella stessa sezione trovi altri aspetti da scaricare. Uno nuovo viene solo proposto, mai installato da solo; un pallino dorato ti avvisa che c'è una novità. Una volta scaricato, un aspetto si tiene aggiornato da solo, resta dopo gli aggiornamenti di sistema e si può rimuovere in qualsiasi momento (se era in uso, l'apparecchio torna a Classic).

Animazioni

Con i VU meter spenti, Now Playing può mostrare al loro posto un'animazione. Si sceglie in Impostazioni → Animazioni — sullo schermo o nell'amministrazione web, dove ognuna ha un'anteprima — oppure dal pulsante delle animazioni accanto all'orologio:

• Nessuna — al posto dei VU meter compare il testo della canzone.
• CD dall'alto — un disco entra dall'alto in un lettore, poi gira.
• Lettore CD — un lettore con il cassetto della fine degli anni '80: il cassetto esce con il disco, il display fluorescente mostra traccia e tempo, e i tasti funzionano — OPEN, i numeri delle tracce, REPEAT, RANDOM, salto e ricerca, play, pausa, stop e POWER.
• Vinile — il braccio con la puntina scende sul disco, poi il disco gira; START/STOP funziona.
• Musicassetta — una cassetta entra in una piastra, poi il nastro passa da una bobina all'altra; i tasti funzionano, REW e FF avvolgono finché li tieni premuti e il cursore regola il volume. L'etichetta mostra il brano in riproduzione.

Si muove solo mentre la musica suona: metti in pausa e rallenta fino a fermarsi. Quando parte un altro album, il disco o la cassetta esce e rientra. Con una radio via internet l'etichetta della cassetta e il display del CD mostrano la stazione e la canzone. Il pulsante dello schermo intero accanto all'orologio mostra l'animazione in grande. Il pulsante di Now Playing che mostra il testo della canzone passa dall'animazione al testo e viceversa.

Altre animazioni da scaricare — nella stessa sezione trovi altre animazioni, dall'elenco firmato di Osmium Sound, come per gli aspetti dei VU meter: una volta scaricata, un'animazione si tiene aggiornata da sola e si può togliere quando vuoi.

Telecomando

Un telecomando può comandare tutto lo schermo: le frecce spostano un anello dorato da un elemento all'altro, OK lo preme, Indietro torna indietro, e il tasto menu fa come tenere il dito su un elemento. È tutto in Impostazioni → Telecomando, sullo schermo e nell'amministrazione web.

• Telecomandi USB — infila la chiavetta: funziona subito.
• Telecomandi Bluetooth — premi Aggiungi un telecomando e di' quale hai. Tre modelli sono conosciuti: Amazon Fire TV (3ª generazione — tieni premuto Home finché la luce lampeggia), Xiaomi Mi Box S (tieni premuti insieme ⋮⋮⋮ e ○ per 7–8 secondi) e G20S PRO (tieni premuti OK e Indietro per 5–7 secondi). Mettilo in accoppiamento e lascialo vicino all'apparecchio: lo trova e lo collega da solo. Finché un apparecchio con schermo non ha un telecomando, resta anche in ascolto di questi tre e ne accoppia uno da solo. Ogni altro telecomando si accoppia cercandolo e toccandolo nell'elenco.
• Mappa dei tasti — un modello conosciuto mostra un disegno di cosa fa ogni tasto la prima volta che compare; puoi rivederlo da Impostazioni → Telecomando. Dopo la prima configurazione, Prova il telecomando ti fa provare una volta i tasti principali.
• Prova e assegna i tasti — premi un tasto per vedere cosa manda, e dagli un altro compito: schermo intero, prossimo aspetto dei VU meter, prossima animazione, apri i preferiti, cerca, riavvia il touch screen, spegni o riavvia…
• Accensione — il tasto di accensione del telecomando non spegne mai l'apparecchio da solo: apre il menu Spegni / Riavvia, con l'anello su Annulla. Il tasto di sospensione fa riposare lo schermo.

I tasti di riproduzione e volume di una tastiera o di una scheda audio continuano a funzionare come tasti e non vengono presi per un telecomando. Dall'amministrazione web puoi scaricare una scheda del telecomando con quello che vede l'apparecchio, da mandare all'assistenza.

Sorgenti musicali

Osmium Sound legge la libreria musicale da una o più sorgenti, configurabili dalle Impostazioni (o durante il setup iniziale):

• Cartella di rete — un NAS o una cartella condivisa su un altro computer. Non serve conoscerne l'indirizzo: il dispositivo cerca i computer e i NAS della tua rete, ne elenca le cartelle condivise e chiede nome utente e password in una piccola finestra solo se la cartella li richiede. Se non riesce a collegarsi, ti spiega il motivo a parole semplici (i dettagli tecnici restano a un tocco di distanza). Puoi comunque scrivere tutto a mano. Una cartella viene aggiunta scrivibile, a meno che il server permetta solo di leggere; ognuna può essere resa scrivibile o di sola lettura in qualsiasi momento — comodo se vuoi anche rippare CD al suo interno.
• Disco USB — un disco USB collegato al dispositivo, "adottato" (condiviso in rete, leggibile/scrivibile). Un disco adottato si rimonta da solo se lo scolleghi e ricolleghi, o dopo un riavvio.
• Disco interno — un secondo disco dentro il dispositivo, dedicato alla musica.
• Una cartella sull'apparecchio stesso — musica copiata direttamente sul disco del dispositivo. Può essere condivisa in rete, così ci copi la musica da un computer.

Dopo aver aggiunto o modificato una sorgente, la libreria si aggiorna da sola. Nell'amministrazione web, Sorgenti musicali è un menu — sorgenti attive, aggiungi sorgente, cartella playlist, cartelle condivise, gestisci i file — dove ogni schermata ha il suo modo per tornare indietro.

In Cartella playlist scegli dove vengono salvate le playlist; condividila in rete per copiarci playlist dal computer. Le playlist create su Windows vengono sistemate da sole, così suonano anche qui.

Streaming e plugin Lyrion

I servizi di streaming (Deezer, Qobuz, TIDAL, Spotify e altri) e le funzioni aggiuntive (UPnP/DLNA, AirPlay, radio) sono plugin di Lyrion Music Server, non parte dell'app Osmium Sound stessa. I più comuni si possono già spuntare durante il setup (il passaggio "Servizi musicali"); per gli altri, o per aggiungerne uno in seguito:

1. Apri la web UI di Lyrion http://<ip-dispositivo>:9000 — vedi Amministrazione web per come trovare l'indirizzo IP.
2. Vai su Impostazioni → Plugin Cerca e attiva il plugin del servizio che vuoi usare.
3. Accedi con le tue credenziali Segui le istruzioni del plugin per il login al servizio.
4. Torna sull'interfaccia Osmium Sound Il nuovo servizio compare da solo nei tab Radio/App — non serve nessun aggiornamento dell'app.

Server Lyrion esterno

Ogni dispositivo Osmium Sound suona di default attraverso il proprio Lyrion Music Server. Da Impostazioni → Lyrion Music Server puoi scegliere tra Interno ed Esterno (sulla mia rete): il secondo usa un server Lyrion già in funzione su un altro dispositivo, trovato per te con una ricerca nella rete — puoi anche scriverne l'indirizzo IP o il nome, per esempio nas.local. Un nome che non si trova viene rifiutato prima di cambiare qualsiasi cosa. Il cambio riavvia il dispositivo. Nella stessa sezione ci sono il nome del player, la versione di Lyrion e l'aspetto del player web.

Far suonare più player in sincronia (multiroom) è una funzione nativa di Lyrion Music Server, gestita dalla sua stessa interfaccia — Osmium Sound non offre una funzione di multiroom propria. Assegna un nome a ogni dispositivo per distinguerli facilmente lì. Dallo schermo del dispositivo puoi anche comandare qualsiasi altro player dello stesso server — vedi Uso quotidiano.

Altoparlanti Bluetooth

Osmium Sound può suonare su altoparlanti e cuffie Bluetooth. È tutto in Impostazioni → Altoparlanti Bluetooth, sullo schermo e nell'amministrazione web:

• Bluetooth — spento finché non serve: da spento la radio Bluetooth resta senza corrente. Senza un adattatore Bluetooth la sezione lo dice; ne basta uno piccolo USB.
• Cerca — metti l'altoparlante in accoppiamento e cerca: compare in una decina di secondi, toccalo per aggiungerlo.
• Ogni altoparlante è un lettore — un altoparlante aggiunto compare nell'elenco dei lettori, nell'app companion e in Lyrion come un lettore a sé, con la sua coda e il suo volume: fagli suonare qualcos'altro, oppure raggruppalo con gli altri lettori. Nome del lettore cambia il nome con cui compare.
• Si ricollega da solo — l'apparecchio si ricollega all'altoparlante appena lo riaccendi. Collega, Scollega e Dimentica sono accanto a ogni altoparlante.

Il Bluetooth serve a mandare fuori la musica: l'apparecchio non riceve musica da un telefono via Bluetooth. Gli accoppiamenti entrano in un backup cifrato, e il reset di fabbrica li dimentica.

Backup e ripristino

Dalle Impostazioni puoi creare un backup completo della configurazione del dispositivo: uscita audio, elenco delle sorgenti musicali, preferenze e playlist di Lyrion, le informazioni su album e artisti scaricate dal web e le correzioni che ci hai fatto, profili di rete Wi-Fi, account e token di abbinamento. I dati sensibili (reti Wi-Fi, account) entrano nel backup solo se scegli di proteggerlo con una passphrase.

• Backup manuale — Impostazioni → Backup → Crea backup adesso, con o senza passphrase.
• Backup programmato — attivabile in Impostazioni; esegue automaticamente un backup settimanale (solo dati non sensibili, dato che non c'è nessuno a cui chiedere una passphrase).
• Ripristino — dalle Impostazioni di un dispositivo già configurato, oppure direttamente durante il setup guidato del primo avvio (vedi Primo avvio e configurazione) per rimettere in piedi rapidamente un dispositivo sostituito o reimpostato.

Aggiornamenti OTA

Osmium Sound e Lyrion Music Server si aggiornano via internet (OTA, over-the-air) da Impostazioni → Aggiornamenti — sullo schermo, nell'amministrazione web o nell'app companion — senza mai dover riflashare la chiavetta USB dopo l'installazione iniziale. Premi Controlla aggiornamenti: entro un minuto ti dice che c'è un aggiornamento, che sei già aggiornato, oppure che non è riuscito a controllare (di solito un problema di rete — Controlla la rete, messo in evidenza proprio lì, trova dove si ferma la connessione).

L'intero sistema arriva come un unico pacchetto firmato digitalmente: il dispositivo rifiuta qualsiasi cosa non sia firmata correttamente, anche se qualcuno riuscisse a manometterne il download. Il dispositivo tiene due copie del sistema una accanto all'altra. L'aggiornamento viene scritto nella copia che non è in uso, mentre il dispositivo continua a funzionare, con l'avanzamento mostrato in tempo reale; il riavvio finale passa alla copia nuova. Se la nuova versione non parte come dovrebbe, il dispositivo torna da solo a quella precedente, entro una decina di minuti. Impostazioni, musica e tutto ciò che hai scaricato sono tenuti separati dal sistema, quindi un aggiornamento non li tocca mai.

Ogni dispositivo può scegliere un canale di rilascio in Impostazioni → Aggiornamenti:

SSH e accesso avanzato

L'accesso SSH è disattivato per impostazione predefinita. Può essere attivato dalle Impostazioni (a schermo o da amministrazione web → Servizi) per manutenzione avanzata o debug. Subito sotto l'interruttore scegli nome utente e password con cui entrare; il pannello mostra poi il comando ssh esatto da usare.

Installare programmi aggiuntivi

Il sistema in sé non si può modificare, ma via SSH il solito sudo apt install <pacchetto> funziona ancora: il programma aggiuntivo viene tenuto separato dal sistema, e sudo apt remove lo toglie di nuovo. Dopo un aggiornamento di sistema il dispositivo, all'avvio, ricostruisce da solo i programmi aggiuntivi per la nuova versione (per farlo gli serve internet). Un pacchetto che sostituirebbe una parte del sistema, o che richiede componenti di sistema più recenti di quelli presenti, viene rifiutato con una spiegazione. Il sistema invece non si aggiorna con apt upgrade ma da Impostazioni → Aggiornamenti.

Per provare un aspetto dei VU meter o un'animazione prima che sia pubblicato, sudo hifi-pack-install FILE.vupak (o .animpak) lo installa con gli stessi controlli degli elenchi online, tranne la firma; --list mostra cosa è installato, --remove vu|anim ID lo toglie. Un'animazione è un piccolo programma che lo schermo esegue: installa solo file di cui ti fidi.

Accesso remoto (Tailscale)

L'amministrazione web offre anche un accesso remoto opzionale via Tailscale, per raggiungere il dispositivo da fuori casa — sul tuo account Tailscale, non su un servizio gestito da terzi.

1. Installa Tailscale Da amministrazione web → Impostazioni → Tailscale, installalo sul dispositivo se non è già presente.
2. Attivalo L'attivazione apre un link di login monouso — aprilo nel browser e accedi al tuo account Tailscale (o creane uno) per autorizzare il dispositivo sulla tua tailnet.
3. Connettiti da qualsiasi luogo Una volta connesso, l'indirizzo IP Tailscale del dispositivo e i dettagli della connessione (inclusa regione/latenza del relay DERP) compaiono nella stessa sezione delle Impostazioni. Raggiungi l'amministrazione web da quell'indirizzo, da qualunque altro dispositivo sulla tua tailnet.

Reset di fabbrica

Il reset di fabbrica cancella tutte le impostazioni, l'account di amministrazione web, le sorgenti configurate, i backup conservati sull'apparecchio, gli aspetti dei VU meter e le animazioni scaricati e gli accoppiamenti Bluetooth, poi riavvia il dispositivo direttamente nella configurazione descritta in Primo avvio e configurazione — come se fosse appena stato installato. La musica copiata sull'apparecchio stesso resta.

È disponibile:

• A schermo, in Impostazioni → Controlli Sistema → Reset di fabbrica (se il dispositivo è in modalità "con schermo").
• Dall'amministrazione web, inserendo la password dell'account amministratore.

Risoluzione dei problemi

Risorse e link utili

• README.md — panoramica del progetto, funzionalità e specifiche
• QUICKSTART.md / GUIDA-RAPIDA.md — guida rapida in inglese/italiano
• ARCHITECTURE.md — documentazione tecnica/architetturale per sviluppatori
• SECURITY.md — policy di sicurezza
• Repository GitHub — codice sorgente, issue, release
• Sito ufficiale — download, app companion
• [email protected] — assistenza