Skip to content
@Noctorium

Noctorium

Noctorium

Noctorium

All your music. One player.

YouTube Music, SoundCloud, Bandcamp, Spotify, VK Music, Apple Music, Deezer and Tidal in one library: on Windows, macOS, Linux and Android — in the car with Android Auto and on the TV with Android TV — in a terminal, and in any browser.

Website · Play in the browser · Your statistics · Download · What's new · Release notes · Discord · Telegram

Latest release Downloads Licence Discord Telegram

Noctorium is a music player with one home, one search, one library, one queue and one player for all of them. It uses your own accounts. When you like a song or edit a playlist in Noctorium, the change is made on the service itself, not kept in a copy here. Open that service tomorrow on any other device and it is there.

What it does

  • Every service side by side. One search shows results from all of them, or from the one you pick. Playlists and liked songs from each sit in the same library, and a queue can mix songs from any of them. Search for music, radio stations, artists or playlists.
  • Artist pages that are whole pages. A banner, their popular songs, then albums, singles, videos, playlists and artists like them, from YouTube Music and SoundCloud. In the library, your liked songs come first, in a card of their own.
  • Pull down to search. On the phone, pull down at the top of Home and the search bar appears, with two menus beside it: which service — all of them at once, YouTube Music, SoundCloud and the rest — and what to look for: Music, Radio, Artists or Playlists.
  • Set up in a minute, or not at all. The first time Noctorium opens, on every platform, a few quick steps: a theme, where to search, autoplay, and your accounts. Skip it whenever you like. It shows once — not after an update or a restart, and never to anyone who used Noctorium before it.
  • Your real accounts. Likes, and playlists you can create, rename, make public or private — or unlisted, with a description, on YouTube Music — or delete, from the computer or the phone, all live on the service. On YouTube Music you can also reorder your playlists and follow artists, and your plays go into your history there, so its own recommendations learn from what you play here. A heart saves to Liked Songs on Spotify, and to My music on VK.
  • Signing in on their page. Your password goes to the service's own page — Google's, SoundCloud's, Spotify's, VK's, Apple's or Tidal's — and never to a form of ours. Only the session is kept, and it stays on your device. The desktop can also be signed in by scanning a QR code with the phone.
  • Spotify, with or without a sign-in. Signed in: your playlists and Liked Songs in the library, Spotify in search with its albums and artists, your top songs and what you played lately on Home. Spotify serves no audio to other players, so each song is matched to the same recording on YouTube Music when it plays. With Premium, Spotify songs play on Spotify itself instead, in your own Spotify app — on the computer, the phone or a speaker — while Noctorium tells it what to play and follows along. Noctorium never decodes Spotify's audio. Spotify answers that sign-in only while the owner of Noctorium's Spotify app has Premium, so two ways need none: follow public playlists by their links, kept in step with Spotify (only their first 100 songs, as that is all Spotify's public page shows), and import every playlist you made and your Liked Songs from Spotify's own data download.
  • Bandcamp, with nothing to sign in to. Search it, open its albums and artists, and get its best-sellers and new releases on Home, in the genres you pick. Give your Bandcamp name and your collection and wishlist are in the library. Bandcamp songs are bought there, not downloaded.
  • VK Music. Sign in on VK's own page: My music and your VK playlists in the library, VK in search, and its suggestions on Home. VK offers its music to no other app, so Noctorium uses your session the way VK's web player does. VK's terms do not allow that, and VK may freeze an account it takes for automated; many songs do not play outside Russia, and VK songs cannot be downloaded.
  • Apple Music, Deezer and Tidal. Search them, open their albums, artists and playlists, paste their links, and see your library from them. Deezer needs only your public profile; Apple Music is signed in on Apple's own page, reached the way its web player is, which its terms do not allow; Tidal needs a free developer app of your own, and Settings walks you through making one. None of them lets another app play its music, so, as with Spotify, each song is matched to the same recording on YouTube Music when it plays.
  • Beta, and said so. Every service but YouTube Music, YouTube and SoundCloud is in beta, and its settings say so above the sign-in: it may not work as it should, and there is a small chance it gets your account blocked. Use those at your own risk.
  • Up next, from the same service. When the queue is about to run out, what comes after it is lined up underneath, from the service of the song that ends it: YouTube Music's radio, SoundCloud's related tracks, more from a Bandcamp artist, VK's suggestions, Spotify's own autoplay. Play one, keep one or drop it, or switch autoplay on and off right there in the queue. A song picked on Home or from a search starts autoplay from it, rather than queueing everything around it. Clear the queue down to the song playing with one button, and Previous takes a song back to its start once it is five seconds in. Close Noctorium and the queue is there next time, with the song you were in picked up where you left it.
  • In a terminal, and in a browser. noctorium is the whole player in a terminal — covers drawn in it, synced lyrics, every theme, by keyboard or mouse, and it keeps itself up to date. In a browser, noctorium-music.vercel.app plays YouTube Music and SoundCloud with nothing to install and no account, your likes and playlists kept in the browser. With your own accounts, noctorium web serves the same player from your computer to every browser on your network: open the link, or scan its code with a phone, and the music plays out of that device, while your sessions never leave the computer.
  • Noctorium Connect. A tab of its own on the computer and the phone: every device on your network, what each is playing, and Play here or Play on any of them — the music moves at the same second, with the whole queue, even between two devices you are not holding. While it plays elsewhere, your own player is the remote: its song, seek bar, buttons and volume drive the device it is on, with "Playing on Desk" along the player bar. Every device's tab stays in step within a second. Both signed in to the same Noctorium account. A switch at the top of the tab turns it off, and then the device neither looks for your others nor can be seen by them.
  • Lyrics, synced where a synced version exists, from LRCLIB, Musixmatch, Genius and others. Switch source right on the lyrics, and Noctorium remembers your pick.
  • Scrobbling to Last.fm, Libre.fm and ListenBrainz, and what you are playing shown on Discord. While a sign-in waits for you, its link is there to copy into any browser.
  • A history that stays home. Every song you listen to, newest first and by day, on your profile on the computer and the phone, to play again or clear. It is kept on the device it was played on and sent nowhere, not even to your Noctorium account.
  • Your listening, counted. Sign in to a Noctorium account, if you want one, and the player counts what you play on your computer and your phone. Read it on the statistics site, or in Noctorium Stats, an app of its own for Windows, macOS, Linux and Android: the last week, month or year or all of it, your top songs and artists, how the services share your listening, the hours and days you listen most, what you played last, and how many days in a row.
  • Which song is this? Noctorium Song Find, an app of its own for Windows, macOS, Linux and Android, listens and tells you — through the microphone, or straight from what the computer or phone is playing, with nothing held up to a speaker. It asks Shazam, AudD, ACRCloud and (on the desktop) AcoustID, links the song on Spotify, YouTube Music, Apple Music, Deezer and SoundCloud, and keeps a history of what it found on the device only. On the phone, its notifications follow along: a countdown while it listens, the seconds it has been looking, then found or not found.
  • In the car and on the TV. The Android app is Noctorium for Android Auto too — Home, your library, the queue, radio, search and voice on the car's screen — and for Android TV and Google TV, on the TV's home screen with pages made for the remote. One APK, one player: pick a song in the car and the phone shows it.
  • Downloads. Save songs for offline listening. On the desktop they are saved as MP3s with their covers. Bandcamp and VK songs stay on their service.
  • Out of the way when you want it. On the desktop, keep the music playing in the tray when you close the window (the menu bar on a Mac), and start Noctorium with the computer, in its window or straight into the tray. On the phone, it keeps playing with the screen locked, even on phones that like to close apps, and a song that will not start after the phone has slept starts itself again where it was. Turn on Keep Noctorium alive and it stays running in the background, and comes back by itself when the phone stops it anyway, carrying on with the song where it was, with a checklist of what that phone needs. And if the phone restricts Noctorium in the background, so that switching apps would stop the music, it says so and takes you to the switch. The song, its length and how far in it is are on the lock screen, in the notification and in OnePlus's Live Alerts bubble. The queue is a button away on Now playing.
  • Stream widgets. On the desktop, show what is playing over your stream in OBS or Streamlabs: switch them on, copy a look's address into a Browser source, and the song, its cover and how far in it is appear on stream. Seven looks — Glass, Minimal, a turning Vinyl, Neon, a Ticker for the edge of the screen, a tall Afterglow card and a Windows 98 window — several at once if you like. Off until you switch them on, and only your own computer can open them unless you allow your network.
  • Make it yours. Twenty-four themes, among them Catppuccin, Nord, Dracula, Gruvbox, Rosé Pine, Tokyo Night, three pure black crimson ones for OLED screens, and four Glow themes: near-black pages under a soft light, Afterglow's in the colour of the cover playing. Or make one of your own. Accent colours, including one taken from the artwork. Liquid glass, and animations throughout that you can switch off. Icons in six sets, from Material's to thin Line strokes, and each service's own logo on the badge that says where a song comes from, or its letters if you prefer. Twelve seek bars, from a hairline to a row of bars like SoundCloud's, a glowing neon line, a ruler or a slider. Twelve player bar layouts on the desktop — a floating dock, an island that opens when you point at it, a stereo's display, a taskbar, two toolbars — and eleven on the phone. Twelve layouts for the now playing screen on the desktop and seven on the phone: the cover filling the screen, Cover flow through the queue, the record on a turntable with its arm crossing as the song plays, the title set as a poster, lyrics that fill the screen. Playback speed from half to double, a volume booster up to 1000% that makes even loud masters clearly louder at every step, the moment you move it, an equaliser, a sleep timer that fades out, and Settings you can search: type "dark mode" or "louder" and it takes you there.
  • A desktop music player of the old school, too. Pick the Toolbar and the Playlist layout: a row of flat buttons with play, pause and stop, the cover docked beside the queue as a table with the columns you choose and the lyrics a tab away, an info bar with a visualiser drawn from the sound itself, and a status bar with the stream's format and how far into the whole queue you are. Or Toolbar 2: the same flat buttons with play and pause as one, and like, lyrics, the queue, the sleep timer, Connect and the speed along the row as well — on the computer, the phone, in a terminal and in the browser.
  • From the keyboard. On the desktop, Ctrl+F brings up a quick search over everything; start it with !ytm, !sc, !sp, !bc, !vk, !am, !dz or !td to search one service. Every shortcut can be changed, and global ones work from any program with Noctorium in the tray. In the terminal, keys of your own.
  • Windows 98 and XP, for real. Pick 98 and Noctorium becomes that desktop: grey bevelled buttons, navy title bars, scroll bars with arrows, Settings as a Control Panel, and Now playing in windows on the teal desktop. Pick Noctorium 98 for the same 98 at night: violet title bars, black lists and fields, and a night sky behind the windows. Pick XP for Luna's blue title bars, Explorer's task pane and the green start button. Each has a taskbar whose clock you can put away, on the desktop, the phone, in a terminal and in the browser.

Get it

In one line, from PowerShell on Windows or a terminal on macOS or Linux. It asks which of Noctorium, the Noctorium CLI, Noctorium Stats, Noctorium Rust and Noctorium Song Find you want, and checks what it downloads against the release's checksums:

irm https://noctorium.vercel.app/install | iex
curl -fsSL https://noctorium.vercel.app/install | sh
If the website is ever down: the same, straight from GitHub
irm https://raw.githubusercontent.com/Noctorium/Noctorium-Installer/main/scripts/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/Noctorium/Noctorium-Installer/main/scripts/install.sh | sh

Or nothing at all: play in the browser. Every file is also here:

Platform Download
Windows Noctorium-Installer-windows-x64.exe, or the setup .exe or .msi from the release
macOS The .dmg from the release: -macos-arm64 for Apple silicon, -macos-x64 for Intel. Open it and drag Noctorium into Applications; it is not signed by Apple, so the first time choose Open Anyway in System Settings, Privacy & Security — or use the one line above, which skips that
Debian, Ubuntu, Mint The .deb from the release, or noctorium-installer-linux-x64
Fedora, RHEL, openSUSE The .rpm from the release, or the same Linux installer
Arch, Manjaro, EndeavourOS The .pkg.tar.zst from the release, or the same Linux installer. From a terminal it is noctorium-desktop; noctorium is the CLI
Any Linux The .AppImage, or the .flatpak (which carries its own mpv), from the release
A terminal, and noctorium web noctorium-cli-<version>-windows-x64.zip, -linux-x64.tar.gz, -macos-arm64.tar.gz or -macos-x64.tar.gz from the release, or the one line above
A browser Nothing to download: noctorium-music.vercel.app
Android The .apk from the release, or Noctorium-Installer-android.apk, which installs Noctorium, Noctorium Stats or Noctorium Song Find on a phone or a TV, or Obtainium
Noctorium Stats noctorium-stats-<version>-windows-x64.zip, -linux-x64.tar.gz, -macos-arm64.zip or -macos-x64.zip, and Noctorium-Stats-<version>.apk for Android, from the release, or the installers
Noctorium Song Find noctorium-song-find-<version>-windows-x64.zip, -linux-x64.tar.gz, -macos-arm64.zip or -macos-x64.zip, and Noctorium-Song-Find-<version>.apk for Android, from the release, or the installers

The installers — a window, or noctorium-installer-cli in a terminal — are small programs that install Noctorium, the Noctorium CLI, Noctorium Stats, Noctorium Rust, Noctorium Song Find, or any of them together. They fetch the right files for your machine, sixteen pieces at a time and all at once, and check them against the published checksums as they arrive, before running anything. The desktop packages carry everything they need, so nothing has to be installed first. After that, both update themselves. On Windows, Noctorium asks once for permission, shows a progress bar with nothing to click through, and opens again when it is done. The CLI checks once a day and takes over the new version after you quit.

On Android, with Obtainium

Obtainium installs and updates Android apps straight from their releases, and every Noctorium app works with it — Noctorium itself on a phone, in Android Auto and on Android TV. Tap a button on the phone or TV with Obtainium installed, and it opens with the app set up:

Noctorium Get it on Obtainium
Noctorium Stats Get it on Obtainium
Noctorium Song Find Get it on Obtainium
Noctorium Installer Get it on Obtainium

Or add it by hand: Add app, the source https://github.com/Noctorium/Noctorium-Installer, and under Filter APKs by regular expression ^Noctorium-[0-9].*[.]apk$ for Noctorium, ^Noctorium-Stats-[0-9].*[.]apk$ for Noctorium Stats, ^Noctorium-Song-Find-[0-9].*[.]apk$ for Noctorium Song Find or ^Noctorium-Installer-android[.]apk$ for the installer — every release carries all four APKs, and the filter picks the right one. Obtainium checks them against nothing but the release itself, so the certificate fingerprint below is how to be sure.

Every release has a SHA256SUMS.txt beside its files. The APK is signed with Noctorium's release key, and its certificate SHA-256 fingerprint is 46:CF:8B:96:C4:37:49:7A:93:AF:76:2B:91:94:AD:11:09:5D:D6:4A:B6:AB:EA:E9:60:C0:A5:98:C5:63:49:ED.

Problems, ideas and news

Tell us on Noctorium's Discord: something that does not work, a service that stopped playing, or something you wish Noctorium did. Say which Noctorium it is — the desktop, the phone, the terminal or the browser — its version, and what happened. Issues here on GitHub are welcome too.

To hear about each new release as it comes out, follow Noctorium on Telegram.

The repositories

Repository What it is
Noctorium-Base The shared Kotlin core: library, queue, providers, playlists, settings, scrobbling, lyrics, Connect. Every Noctorium is built on it, so they behave the same rather than nearly the same. Beside it, jvm: yt-dlp, mpv and the rest a computer shares.
Noctorium-Desktop Windows, macOS and Linux. Compose Desktop, mpv for audio, yt-dlp for the services, an embedded Chromium for sign-in.
Noctorium-cli The terminal player, and noctorium web, which serves the web player to the browsers in the house.
noctorium-web-player The web player: the page noctorium web serves, and the hosted player at noctorium-music.vercel.app, whose music comes straight from the services to the browser.
Noctorium-Mobile Android. Compose, Media3 for audio, NewPipeExtractor for the services, the system WebView for sign-in. Builds in Android Auto and Android TV.
Noctorium-Android-Auto Noctorium for Android Auto: the car's menu, search and voice, over the phone app's Media3 session.
Noctorium-Android-TV Noctorium for Android TV and Google TV: Compose for TV pages for the remote, over the phone app's state.
Noctorium-Installer The release pipeline, the releases themselves, the small installers and the one-line install scripts. This is what the in-app updater watches.
Noctorium-Service The optional Noctorium account, which keeps your listening statistics, and the statistics site that shows them.
Noctorium-Stats-Desktop Noctorium Stats for Windows, macOS and Linux, in Rust: your statistics from the account, in a window of their own.
Noctorium-Stats-Mobile Noctorium Stats for Android, in Dart with Flutter.
Noctorium-song-find-desktop-rust Noctorium Song Find for Windows, macOS and Linux, in Rust: which song is playing, from the microphone or the computer's own sound.
Noctorium-song-find-mobile-dart Noctorium Song Find for Android, in Dart with Flutter: from the microphone or what the phone is playing.
Noctorium-Website noctorium.vercel.app, which always offers the latest release.

To build the desktop app you need JDK 21:

git clone --recursive https://github.com/Noctorium/Noctorium-Desktop.git
cd Noctorium-Desktop && ./gradlew run

Noctorium was called Spiceity before 0.4. It is an independent third-party client, free software under the GPL-3.0, and not affiliated with Google, YouTube, SoundCloud, Bandcamp, Spotify, VK, Apple, Deezer, Tidal, Last.fm, Libre.fm, ListenBrainz or Discord.

Popular repositories Loading

  1. Noctorium-Base Noctorium-Base Public

    Kotlin 1

  2. Noctorium-Service Noctorium-Service Public

    TypeScript 1

  3. Noctorium-Desktop Noctorium-Desktop Public

    Kotlin 1

  4. Noctorium-Mobile Noctorium-Mobile Public

    Kotlin 1

  5. Noctorium-Installer Noctorium-Installer Public

    Rust 1

  6. Noctorium-Website Noctorium-Website Public

    TypeScript 1

Repositories

Showing 10 of 16 repositories

Top languages

Loading…

Most used topics

Loading…