NicotinD TV

NicotinD TV

Android TV player for your self-hosted NicotinD music server

Kevin Roberts Online Media Player

Description

NicotinD TV is the Android TV client for a self-hosted NicotinD music server. You run the server on your own machine; this app sits on the TV home row and streams your library to the living room. There is no NicotinD account, no cloud service, and nothing to sign up for — the only server the app talks to is the one whose address you give it.

You will need a NicotinD server before this app is useful. It runs in one Docker container on anything from a spare laptop to a NAS.

Built for a remote, not a touchscreen

This is a separate app from the phone client, not the same screens stretched out. It ships a ten-foot player, D-pad navigation throughout, and predictable Back behaviour, and it registers a channel on the Android TV home screen.

What it does

* Browses and streams your library — artists, albums, songs, genres, with cover art sized for across-the-room viewing.
* Metadata-driven radio that picks what comes next from BPM, musical key, genre and mood similarity rather than from a recommendation service.
* Synced lyrics with a karaoke-style vocal-mute option — the reason a lot of people want music on a TV in the first place.
* Plays in the background with system media controls, and accepts playback started from another NicotinD device.
* Multi-user, with per-user settings on one shared library.

Privacy

The app talks to your server and nothing else. No analytics, no advertising identifiers, no third-party SDKs. Your listening history lives in your own database.

Connecting it

TVs have no camera, so you connect the way TV apps always have: type your server's address, or enter the pairing code your server displays. This is not a limitation of this build — it is the only path on any TV.

About this build

This is the same APK the project publishes on its GitHub releases — one build, no F-Droid-only variant, and no proprietary library of any kind.

Installed from F-Droid, it updates through F-Droid, and its own in-app update button hides itself. That button exists for people who sideload, where it is the only way to update; the app asks Android who installed it and removes the control when a store did. This is why it declares the "install unknown apps" permission even though F-Droid will never use it here.

The TV app is a separate package from the phone app, so the two install side by side rather than replacing each other. If you sideloaded a TV APK before version 0.7, that older one used the phone package name and will not be upgraded by this — uninstall it by hand.

Free software

NicotinD is licensed under the AGPL-3.0. Source, issues and documentation: https://github.com/kevinch3/NicotinD

What’s new (0.8.132)

• acquisition: one hunt scheduler with priority lanes in front of the source (#1978)
• agents: an unattended token writes genres by itself only once its proposals are accepted (#1987)
• artists: list related artists that are not in the library, with a way to look for them (#1982)
• artists: store band, member and collaboration links, and show them first in Related artists (#1984)
• audit: flag albums whose track artists look like composers (#1980)
…and 43 more

Versions

Version Date Size Requires Android Download
0.8.132 current
990365b2f9ced56f…
2026-11-20 2.4 MB API 26
0.8.130
bbdd5eaf6860ef9c…
2026-11-17 2.3 MB API 26
0.8.127
00337eb26b119673…
2026-11-13 2.3 MB API 26

Permissions

What the app asks the system for. Android only grants sensitive access after you confirm it.

  • Internet accessSend and receive data over the internet.
  • Foreground serviceKeep running in the background, visible in the status bar.
  • FOREGROUND_SERVICE_MEDIA_PLAYBACK
  • NotificationsShow notifications.
  • Prevent sleepingKeep the device from going to sleep.
  • Install appsStart the installation of other apps.
  • VibrationControl the vibration alert.
  • Network stateCheck whether and how the device is connected.
Show 3 more permissions
  • providers.tv.permission.WRITE_EPG_DATA
  • providers.tv.permission.READ_EPG_DATA
  • tv.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION

Comments