kawaii-player | Multimedia player , media library manager | Media library

For Arch Linux users, PKGBUILD is available in arch folder. Arch Users can also get package from AUR. Latest release, thanks to Nocipher and git-version, thanks to SolarAquarion. For Ubuntu or Debian based distros.
For Arch Linux users, PKGBUILD is available in arch folder. 1. First install pytaglib from AUR 2. Create package from PKGBUILD using command 'makepkg -s' and then install using 'sudo pacman -U'.
Arch Users can also get package from AUR. Latest release, thanks to Nocipher and git-version, thanks to SolarAquarion.
For Ubuntu or Debian based distros. Users can directly go to Release section, download appropriate .deb package, and install it using sudo apt install ./kawaii-player-<version>.deb If a user wants to install the application directly from source: $ git clone https://github.com/kanishka-linux/kawaii-player (or directly fetch tar.bz2 or .zip from release section and extract it, if user wants stable release) $ cd kawaii-player/ubuntu $ python3 create_deb.py The above steps will create a .deb package from latest source, which users can install using apt. Specifying the path to the .deb is important when installing, otherwise apt will look for the package kawaii‑player‑<version>.deb online instead of the working directory. PyQt5 available in ubuntu repository is normally older compared to latest release and packages QtWebKit (which has been deprecated since Qt-5.6) instead of QtWebEngine. If user wants to try the application with latest PyQt5 version with QtWebEngine as browser backend, then they should install the application first as per the steps given above and then they should use following command to install PyQt5 using pip (only possible for 64-bit systems). $ sudo pip3 install PyQt5 sip Once PyQt5 installed using pip3 then user needs to change 'BROWSER_BACKEND=QTWEBKIT' to 'BROWSER_BACKEND=QTWEBENGINE' in '~/.config/kawaii-player/other_options.txt' file. If PyQt5 installation using pip3 is giving some problem then user can remove it using following command $ sudo pip3 uninstall PyQt5 sip and then change 'BROWSER_BACKEND' to 'QTWEBKIT' in 'other_options.txt' file.
Using self contained binary for 64-bit gnu/linux systems: Grab 'gnu.linux.x86_64-bin.7z' package from latest stable release section, extract it, go to the extracted folder, open terminal in it and execute following commands, to directly open the application: $ chmod +x kawaii_player $ ./kawaii_player kawaii-player from version 2.0 onwards contains headless browser supporting both qtwebkit and qtwebengine as backend. It is important for working of some particular kind of addons. In 64 bit binary, the included headless browser supports only qtwebkit as backend (as available in ubuntu 16.04 LTS). Users can activate it using command: $ chmod +x hls_cmd_webkit The 64-bit binary is built against Ubuntu 16.04 LTS as base and contains all python based dependencies. Users will have to install only non-python based dependencies like mpv/mplayer/ffmpegthumbnailer externally using their native package manager. Note : From v3.6 onwards, self contained binary won't be made available for gnu/linux distros. Users are advised to use either setup.py and install dependencies manually, or ask their distro maintainers to provide package for their distro by looking at either setup.py, or deb/AUR package.
Using setup.py (Common method for all including gnu/linux, windows and other unix like systems): (first install python3, python3-setuptools) $ git clone https://github.com/kanishka-linux/kawaii-player (or directly fetch tar.bz2 or .zip from stable release section and extract it) $ cd kawaii-player $ python setup.py sdist (or python3 setup.py sdist) $ cd dist $ sudo pip3 install 'pkg_available_in_directory' (or pip install 'pkg_available_in_directory') Note: use sudo depending on whether user wants to install the package system-wide or not. Note: use pip or pip3 depending on what is available on your system. pip3 will essentially install most of the python-based dependencies along with the package. Users only have to install non-python based dependencies such as mplayer/mpv,ffmpegthumbnailer,libtorrent and curl/wget manually. On windows ffmpegthumbnailer is not available, hence thumbnails will be generated by either mpv or mplayer itself. From non-python dependencies, users need to install atleast mpv (or mplayer) as playback engine; and atleast curl (or wget) for fetching web pages apart from default pycurl, in case there is some problem with pycurl. If pycurl doesn't work or can't be installed, then users should edit Preferences->Other->Get Library to either 'curl' or 'wget'. Note: GNU/Linux distro users have to install PyQt5 and other python based dependencies (as listed below) using their native package manually in this method. Once application is installed, launch the application using command kawaii-player or kawaii-player-console from the terminal.
Tips for Windows users. If users find that some python dependencies (particularly pycurl and lxml) can't be installed properly, then they should grab appropriate binaries of these packages from gohlke's site. Once all python based dependencies are installed, users need to install non-python dependencies like mpv/mplayer or curl/wget. In order to install these non-python packages, just grab binaries of these packages from official sites, extract them and add their path to window's system path. If users are finding some difficulty in setting path variable, then they can just dump all these extracted non-python binaries i.e. mpv/mplayer and curl/wget to the location '~/.config/kawaii-player/src/'; once it is done the application will automatically recognize them. Python3-libtorrent as a binary is not available on PyPI, hence users will have to build and install it from source, in order to use torrent-streaming feature. Directly using self contained binary: kawaii-player from v2.5+ onwards is being released with experimental binary for 64-bit windows 10. This binary packs all the python based dependencies (except python3-libtorrent) along with mpv and curl. Just grab the binary for windows from release section, extract it, go to extracted folder and then click on kawaii_player file to launch the application. In ~.config\kawaii-player\other_options.txt file, windows users have to change 'Preferences->Other->Get Library' to 'curl' from pycurl, if it is not already curl. Users can also change 'YTDL_PATH=DEFAULT' to 'YTDL_PATH=AUTOMATIC', that will grab updated youtube-dl automatically, for playing youtube videos. On windows youtube-dl requires 'msvc 2010 redistributable package (x86)' - which they have to install from microsoft's website.
Tips for macOs users (Installing dependencies). $ brew install mpv mplayer ffmpeg wget openssl terminal-notifier libtorrent-rasterbar socat $ pip3 install lxml bs4 Pillow mutagen PyOpenGL PyQt5 sip PyQtWebEngine $ PYCURL_SSL_LIBRARY=openssl LDFLAGS="-L/usr/local/opt/openssl/lib" CPPFLAGS="-I/usr/local/opt/openssl/include" pip3 install --no-cache-dir pycurl Support for macOS has been added from v3.9+ onwards. Once dependencies are installed, use git master branch and install package manually using setup.py as mentiond in the common method above. After opening the application go to Preferences->Config, check Use this config file and add/modify vo=libmpv and ao=coreaudio. Users can modify other parameters also as per need and then need to save changes, before playing any video. kawaii-player has beent tested only with macOS Mojave. On macOS, kawaii-player (v3.9) will open separate window for the video, since OSX does not support window embedding of foreign processes. Therefore playing video within thumbnails won't work along with varios thumbnail modes and detached video mode. However, rest of the features like video library management, torrent streaming, pc-to-pc casting, media server, remote control etc.. will work as expected. Support for macOS is in experimental stage. Update: From v4.0+ onwards, it is posiible to embed video within kawaii-player application on macOS, by using libmpv as backend. Select libmpv from sidebar, and restart the application. Make sure that libmpv is located somewhere in the system path. Note: If libtorrent-rasterbar is not working for torrent streaming, then edit brew formula and update download url location (point it to libtorrent-rasterbar v1.1.12), and then install it from source.
(This feature is available only in the latest changes.). Create ~/.config/kawaii-player/new_home.txt file. And add new directory location for config directory, after that restart player. One needs to copy manually all config files and directory to new location in the beginning, otherwise application will recreate all configs considering config folder as empty.