Server

Server

The TakeoutFM server, known as Takeout, indexes organized media files in S3 (or local) using MusicBrainz, ListenBrainz, Last.fm, Fanart.tv, and TMDB. Indexed media is browsed using Takeout APIs and securely streamed directly from S3 or local storage. Music, movies, TV shows, podcasts, and radio are supported. Takeout is built as a single binary that includes all server functionality including media syncing, streaming, REST APIs, and a builtin web UI that plays music, radio, and podcasts.

Features

  • Music with rich metadata, album and artist artwork
  • Movies and TV shows with cast, crew and posters
  • Podcasts with series and episode metadata
  • Internet radio stations (pls)
  • Channels with a TV-style guide of movies and shows
  • Favorite artists, tracks, movies, and TV shows
  • Podcast subscriptions
  • Watch/listen progress for movies, TV shows, and podcasts
  • Statistics for watch/listens with aggregations
  • Media streaming indirectly from S3 using pre-signed time-based URLs
  • Media streaming for local files using JWT tokens
  • Powerful search and playlists
  • User-based access control using cookies, JWT tokens, and 2FA with TOTP
  • Device codes to sign in TVs, watches, and desktop apps
  • Login throttling and hardened cookies and headers
  • Builtin web UI with a player, queue, favorites, and activity
  • Server-based playlist API using jsonpatch
  • XSPF (“spiff”) and JSPF playlists
  • Supports caching of API metadata for faster (re)syncing
  • Image proxy with pre-caching support
  • Supports systemd
  • REST APIs are available to build custom interfaces
  • Written in Go, with SQLite3, Bleve, Viper, and Cobra

Documentation

Quick Start Setup Media Radio Channels Search Images Configuration Systemd