Newer
Older
* PHP PDO SQLite tested (any PDO DB should work, but untested)
* [Lastf.fm](https://last.fm) Account with [API Support](https://www.last.fm/api/)
* [Youtube](https://youtube.com) Account with [API Supprt](https://developers.google.com/youtube/v3/)
# Installation
1. Place this folder somewhere under your document Root e.g.: http://example.com/lfmtube
2. run `composer install`
3. copy the file `conf/example.settings.json` to `conf/settings.json`
4. create a [Last.fm User](https://www.last.fm/user/ravermeister) with a [Developer API](https://www.last.fm/api/) key
5. create a [Youtube User](https://www.youtube.com) with a [Developer API](https://developers.google.com/youtube/v3) Key
The [Last.fm Youtube Radio](https://lastfm.rimkus.it) searches and plays the listened tracks of a given [Last.fm User](https://www.last.fm/user/ravermeister) on [YouTube](https://youtube.com). 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.
The Timer is designed to stop when player is paused, and will continue when the player continues to play.
Key binding | Command | Control | | Key binding | Command | Control
----------- | ------- | ------- | - | ----------- | ------- | -----
ctrl+1 | Player Window | Page Navigation | | enter | Play/Pause | Player
ctrl+2 | Last.fm Playlist | Page Navigation | | space | Play/Pause | Player
ctrl+3 | Custom User Playlist | Page Navigation | | left | *Rewind Track | Player
ctrl+4 | Topsongs Playlist | Page Navigation | | right | *Fast Forward Track | Player
ctrl+5 | Last.fm Users | Page Navigation | | up | Volume Up | Player
| | | | | down | Volume Down | Player
| | | | | ctrl+right | Next Track | Player
*The forward/rewind amount of time is increased when the functions is called fast in a row, and resetted to default afterwards.
You can send any Title to your personal song list (will be stored in browser cache), which is saved during a browser restart.
You can sarch any [Last.fm User](https://www.last.fm/user/ravermeister) 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](https://www.php.net/manual/de/function.preg-match.php) 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.
- __conf__ Configuration Files and [SQLite Database](https://sqlite.org)
- __conf/settings.json__ copy from `settings.example.json`, here you have to adjust the Youtube/Last.fm 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/lib__ all required js dependecies e.g [JQuery](https://jquery.com/)/[Vuejs](https://vuejs.org/) files
- __js/lib/libvue__ all [Vuejs](https://vuejs.org/) instances
- __php/json__ all required php json handler