Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
Author Jonny Rimkus <>


  • PHP >= 5.6 (last test with 8.0)
  • PHP PDO SQLite tested (any PDO DB should work, but untested)
  • Composer (See composer.json)
  • Account with API Support
  • Youtube Account with API Supprt


  1. Place this folder somewhere under your document Root e.g.:
  2. run composer install
  3. copy the file conf/example.settings.json to conf/settings.json
  4. create a User with a Developer API key
  5. create a Youtube User with a Developer API Key
  6. enter the API keys in the settings.json
  7. open and enjoy


  1. copy the file conf/example.settings.json to conf/settings.json
  2. create a User with a Developer API key
  3. create a Youtube User with a Developer API Key
  4. enter the API keys in the settings.json
  5. run or docker.bat
  6. open http://localhost and enjoy


The Youtube Radio searches and plays the listened tracks of a given User on YouTube. It is possible to search for alternative Youtube Videos or enter a video url directly. The Tracks which have a fixed Video Id will have a '*' prefixed. You can create your own playlist via menu 'add to playlist'. Additionally there is a Chart list which will be updated each time a song is heared. The Chart Counter works as follows:

  • get the length of the Song divided by 2. if it is greater than 2 minutes use 2 minutes as timeout, otherwise use calculated length.
  • when the Timeout is reached, increase playcount for Song.

The Timer is designed to stop when player is paused, and will continue when the player continues to play.


The following global Shortcut keys are supported:

Key binding Command Control
space Play/Pause Player
up Volume Up Player
down Volume Down Player
left *Rewind Track Player
right *Fast Forward Track Player
ctrl+left Previous Track Player
ctrl+right Next Track Player
ctrl+1 Player Window Page Navigation
ctrl+2 Playlist Page Navigation
ctrl+3 Custom User Playlist Page Navigation
ctrl+4 Topsongs Playlist Page Navigation
ctrl+5 Users Page Navigation
ctrl+shift+right next Page Playlist Navigation
ctrl+shift+left previous Page Playlist Navigation

*The forward/rewind amount of time is increased when the functions is called fast in a row, and resetted to default afterwards.

Personal Songlist

You can send any Title to your personal song list (will be stored in browser cache), which is saved during a browser restart.

Listen to other User's Song Timeline

You can search any User and listen to the Song Timeline.

Admin interface

There is an admin php cli Interface for Importing the replacement.csv Files and generating the sitemap.xml file.
Call php admin.php inside the lastfmtube Folder for more info.


You can use Regular Expressions for Replacing Artist and Title information if the Song information is messy, sothat the search string that is send to youtube can be corrected in an efficient way. The csv is stored in the database after importing through the admin cli Interface. New- and Changed Files can be (re-)Imported with the admin interface at any time. See the init.replacement.example.csv for more details.

Directory Structure:

  • conf Configuration Files and SQLite Database
  • conf/settings.json copy from settings.example.json, here you have to adjust the Youtube/ settings for the player.
  • conf/init.replacements_example.csv This is an example file for the Track correction CSV files which you can import via the Admin-cli interface. Regular Expression Groups can be used to define replacements for a specific part of a track to e.g. remove [unnknown] from the Song Titles, extract the artist name from the title etc.
  • conf/lasttube.db this is the sqlite Database (will be created automatically)
  • themes place new themes into this directory. (theming is untested) simply copy an existing theme directory and rename it to your new theme name (and adjust settings.json as needed)
  • locale here you can localize the Strings. currently supported langs: english and german to create a new language, copy an existing language file and rename it to the country specific code, e.g. locale_nl.json for netherland.
  • js main js and dependency config. Tie all js stuff together
  • js/control all js Controller (player,page,playlist)
  • js/control/page js Page Controller (navigation etc.)
  • js/control/player js Player Controller (including chart timer)
  • js/control/playlist js Playlist Controller (actions in the playlist view)
  • js/lib all required js dependecies e.g JQuery/Vuejs files
  • js/vueimpl all Vuejs instances
  • js/vueimpl/page Vue bindings for welcome page
  • js/vueimpl/player Vue bindings for the player page
  • js/vueimpl/playlist Vue bindings for the playlist page
  • js/vueimpl/userlist Vue bindings for the userlist page
  • php/json all required php json handler
  • php/api all API handlers (youtube/ API)
  • php/util all other php libs
  • tmp temp folder for generated templates