Installation had been tested only in Windows. Other OS might work (provided MPV can run), however I'll not be able to test it out.
- Edit the config.ini according to your needs
- Find some KTV videos (due to copyright and file size, I'm not able to provide them)
- Run songeditor.exe to modify the database. If not sure on the fields, see below for more info
- Run the program
pyktv is a simple KTV program for home use. It support dual screen (and works best on dual screen), with 1 main TV playing the video, and another smaller screen for selecting the songs.
Current pyktv features:
- Search by song name
- Select by index number
- Select by Artist, sub-divide to region and type. It is up to you to define what is region and type (eg, region is country of singer, type is male/female/group/etc)
- Select by song category
- Select by number of characters
- Youtube playlist
- DLNA support, pyktv will automatically find DLNA servers on your network
- Web server (scan QR code to access)
| key | description |
|---|---|
| F1-F4 | As seen on screen |
| 0-9 | As seen on screen |
| F5/Pgup | Page up |
| F6/Pgdn | Page down |
| F10 | Next song |
| F12 | Main menu |
| Spacebar | (Local) Switch between voice and music tracks (Youtube) Switch between stereo/left/right |
| Backspace | Previous page |
| A-Z | During search, you can use A-Z to search |
| - | Key down |
| + | Key up |
| = | Key reset |
Edit config.ini to change the default settings
Mouse/touchscreen works as well
pyktv have a very simple web server. Use your smartphone/tablet to browse to your computer port 5000, your browser will need to have Internet and in the same network as your computer.
eg, http://{computer_ip}:5000/ (replace computer_ip with your actual computer IP address)
Just scan the QR code on screen to access
Read config.ini on how to edit
Google for programs to edit sqlite file.
There are 3 tables in the database.
| Field | Type | Description |
|---|---|---|
| id | INT | Running number |
| index | INT | index number, for selecting by index |
| title | TEXT | title of the song |
| search | TEXT | search (must be A-Z in caps) |
| chars | INT | number of char in title |
| singer | TEXT | artist |
| singer2 | TEXT | for multiple artist, use singer2-10 in order |
| singer3 | TEXT | |
| singer4 | TEXT | |
| singer5 | TEXT | |
| singer6 | TEXT | |
| singer7 | TEXT | |
| singer8 | TEXT | |
| singer9 | TEXT | |
| singer10 | TEXT | |
| language | TEXT | language of song |
| style | TEXT | song category |
| channel | TEXT | which channel is music only (L, R, 0, 1) |
| volume | TEXT | Volume to increase (in decibel(dB)), put - to decrease. If there's multiple tracks, separate with comma by tracks |
| library | TEXT | which library it belongs to |
| media_file | TEXT | media file name within the library |
| library2 | TEXT | which library the 2nd audio track belongs to |
| media_file2 | TEXT | the 2nd audio track of media file name within library2 (can be audio or video) |
| remark | TEXT | remarks |
| order_time | INT | [internal use] how many times the video is played |
note: library and media_file must be filled in. The final file name will be library+media_file
note2: to use online (eg youtube) links, leave library empty
| Field | Type | Description |
|---|---|---|
| id | INT | Running number |
| name | TEXT | singer name |
| search | TEXT | search (must be A-Z in caps) |
| region | TEXT | region of singer |
| type | TEXT | type of singer (eg M/F/Group/etc) |
| remark | TEXT | remarks |
| Field | Type | Description |
|---|---|---|
| id | INT | Running number |
| name | TEXT | name for display |
| user | TEXT | user of the playlist/channel |
| url | TEXT | youtube url |
| enable | INT | 1=enable, 0=disable |
YouTube plugin only supports playlist (https://www.youtube.com/playlist?list=xxx), user playlist (https://www.youtube.com/user/xxx/playlists), and user (https://www.youtube.com/user/ziller)
I will recommend not to link to a huge list, as it takes a long time to download the list everytime it is clicked. For some youtube users who have a big list, I'll suggest that you point to their playlists instead (https://www.youtube.com/user/xxx/playlists)
And of course Internet connection is required for YouTube to work.
| Field | Type | Description |
|---|---|---|
| id | INT | Running number |
| root_path | TEXT | The root directory |
| enabled | INT | 1=enable, 0=disable |
| last_mirror | TEXT | for future expansion |
| mirror1 | TEXT | mirror1 to mirror10 - Alternate dir |
| mirror2 | TEXT | If the file cannot be found in the root_path, program will try find the file in mirrors |
| mirror3 | TEXT | Useful if you have backups on another harddisk |
| mirror4 | TEXT | |
| mirror5 | TEXT | |
| mirror6 | TEXT | |
| mirror7 | TEXT | |
| mirror8 | TEXT | |
| mirror9 | TEXT | |
| mirror10 | TEXT | |
| available | INT | for future expansion |
To run from sourcecode, install the python packages according to requirements.txt
$ pip install -r requirements.txt
Download MPV library from https://mpv.io/ and put it in the path (For Windows, download mpv-2.dll) If there's no library for the OS you're using, you'll need to compile it from MPV source and drop the library file in the root of the project
If you want to use the media checking features in Song Editor, download ffmpeg and put it in the path (or install from dnf/apt)
-After downloading youtube_dl source (or from pip), edit the code ytdl-org/youtube-dl#15787
fixed in newer version of youtube_dl
The program use MPV to play file.
Try download MPV from their site and playing the video using MPV. If it not able to play the video file, but other players is able to play it, report the bug to MPV.
(MPV uses ffmpeg to decode almost all videos, so it should be able to play almost any video)
Make sure yt-dlp.exe in the same directory as the program, MPV will require yt-dlp.exe to play the video
Some of the Youtube videos are restricted by country. Make sure that you can play it on your browser on the same computer. If it can be play, try playing it in MPV.
The program is using youtube-dl to download the playlist (last version 2021.12.17, so many functions may or may not work)
Try downloading youtube-dl.exe and run youtube-dl.exe -j --flat-playlist url If it is not able to download,
report bug under youtube-dl project. If the latest version is working, let me know the url so that I can update the
library.
Due to copyright (and huge video files), I cannot provide you with the ktv video files. You'll need to buy the video files/vcd and edit the database yourself.
Due to the number of 3rd party libraries used, those libraries are huge!