Kawaii-Participant is Audio/Video supervisor and mutlimedia participant (based mostly on mpv and mplayer) with PC-To-PC casting function, together with functionalities of moveable media server and torrent streaming server.


  • Options

  • Taking part in Mode

  • Thumbnail Mode

  • Media Server

  • Peer to Peer Mode

  • Common Playlist Era

  • Torrent Streaming Participant

  • Utilizing Internet Interface

  • Casting Assist

  • Distant Management

  • YouTube Participant

  • Minimal Music Participant

  • Indifferent Video (Image in Image) Mode

  • Addons (Plugins) Construction

  • Dependencies and Set up

  • MPV Enter IPC Server

  • Utilizing VLC backend

  • Troubleshooting

  • Transient Documentation

  • Newest Secure Launch

  • Contacts

  • Wiki


  1. Mix Audio-Video Participant and Supervisor.

  2. Bookmark and categorize sequence within the library (like Watching, Incomplete, Fascinating and so forth..).

  3. Audio-Video administration functionalities utilizing sqlite3.

  4. Customized Addons Assist for viewing content material of varied websites instantly on the participant.

  5. Assist for downloading fanart/posters and different data akin to abstract or biography from web websites akin to TVDB and final.fm.

  6. Thumbnail Grid Mode Assist.

  7. Inner net browser with customized proper click on menu for manually downloading desired fanart and poster for library assortment.

  8. System Tray Assist (Present tray icon is short-term which can change in future).

  9. MPRIS2 assist and integration with sound menu applet.

  10. Customized Playlist and queueing assist.

  11. Remembers many of the final settings, and may opens up instantly final watched sequence within the library.

  12. Particular Minimal Mode Music Participant for listening solely music (Obtainable in System Tray context menu).

  13. Historical past Supervisor for each addons and native content material.

  14. mplayer/mpv inner participant.

  15. Higher buffer administration for mplayer on low bandwidth community.

  16. Assist for opening video in exterior gamers like vlc, smplayer or kodi.

  17. Torrent streaming participant/server

  18. Media Server Functionality

  19. Headless Media Server mode utilizing Xvfb

  20. Youtube wrapper utilizing qtwebengine/qtwebkit

  21. Indifferent Video (Image in Image) Mode

  22. Common Playlist Era

  23. Internet Interface for accessing media server content material

  24. PC-To-PC Casting

  25. Browser-To-PC Casting

  26. Distant Management utilizing net interface

  27. Peer to Peer Mode

  28. Obtainable in three themes together with darkish and system theme (from v3.1 onwards).

  29. Gapless Playback of Community Streams

  30. Reside Seekbar Preview

Taking part in Mode



Few extra newest screenshots can be found in launch notes of v3.1.1 and v3.3.0

Thumbnail Mode



Thumbnail Mode of the applying is exclusive within the sense that customers can instantly watch video inside the thumbnail itself by choosing applicable mode from 3 to five. In thumbnail mode customers have possibility to vary default generated thumbnail.
Thumbnails of native video recordsdata are mechanically generated with the assistance of ‘ffmpegthumbnailer’.

Media Server


The media server performance might be began by choosing ‘Extra->Begin Media Server’ possibility. By default media server will begin on ‘‘ i.e. default loop-back tackle of your machine. In an effort to use it as media server which might be accessed from any gadget on the identical native community, you need to change this loop-back tackle ‘’ to your native community tackle which usually begins with ‘192.168.x.y’. Person can verify and alter the default tackle from ‘Extra->Preferences->Media Server’.


A quite simple net interface (as proven above) has been offered for media server, from which customers can entry their audio/video assortment managed by kawaii-player participant. In case your media server is ‘’, then net interface might be opened at or From this interface, customers can generate common playlist in m3u format which might be performed by any media participant on the native community, which helps http streaming akin to mpv,vlc and so forth..and that too on any platform. If customers do not wish to open net interface then they will get the media server playlist instantly on any participant by opening url ‘‘ from inside the participant itself, and the present media server playlist can be instantly out there within the participant. Alternatively customers can use curl or wget to get the playlist, and reserve it with extension ‘.m3u’, which then might be opened with any participant which acknowledges the m3u format.

Use like Streaming Radio: The media server can be utilized just like web radio station with out transcoding. It will not behave like actual web streaming radio, however it may be made to imitate like one. If server tackle is ready to ‘’, then you need to have the ability to entry the present operating file within the playlist on the tackle ‘‘. If person will use this media server IP tackle in repeat (loop) mode on the consumer facet, then the consumer will mechanically play all the things, which is being performed by the kawaii-player in it is playlist. If mpv or mplayer are used as shoppers then their instructions will appeared like as beneath:

	$ mpv --loop
	$ mplayer -loop 0

Experimental Headless Mode utilizing Xvfb: It is attainable to make use of the server in headless mode utilizing xvfb. Customers want to put in xvfb first after which ought to run following command:

	(First set multimedia library path manually in *~/.config/kawaii-player/native.txt*)
	$ xvfb-run --server-args="-screen 0 640x480x16" kawaii-player --start-media-server --update-video-db --update-music-db
	In an effort to add person and password in headless mode append '--user {username} --password {password}' to above command.
	If openssl is put in then for producing ssl certificates append '--generate-ssl {Atleast 8-character size passphrase}' to the above command.

In native house community, if cookie and https isn’t enabled for media server then, one can entry varied media server playlists instantly from vlc utilizing easy urls.

If url ends with .htm then media server will return html web page which might be considered with the assistance of browser. However if you happen to connect ‘.m3u’ or ‘.pls’ to url then it would instantly return the playlist which might be performed by any participant.If no extension is connected on the finish, then m3u playlist can be despatched to the consumer.

Urls which might entry the media server have a quite simple construction. Default url is ‘/stream_continue.htm’ which is able to return present playlist viewable in browser, whereas ‘/stream_continue.m3u’ will instantly ship playlist in m3u format.
The kawaii-player participant, has many sections like music,video,playlist and so forth..that are referred as web site in url. A few of them have subsections like music has subsection artist,album and so forth..which you’ll be able to see within the participant. Now if you wish to seek for artist say ‘yuki kajiura’, then required url ought to appear to be ‘/web site=music&choose=artist&s=yuki+kajiura’. If person will open this url utilizing vlc then then they’ll instantly get all songs of artist ‘yuki kajiura’ instantly on vlc as m3u playlist, with out even going to net browser. And as gamers akin to vlc or mpv can play each format you throw at them, transcoding isn’t required in any respect on the consumer facet,besides on cellular platform. However on cellular platform additionally, many of the frequent codecs might be simply performed by cellular browsers and vlc with out transcoding. If cookie isn’t enabled for this media server, then url entries of the playlist will not change within the native non-public community. Due to this fact, person can create varied playlist and may use them with vlc or mpv (if playlists has blended audio and video content material) on a regular basis; or they will use some native music participant like audacious or clementine in case playlist comprises solely audio.

See also  Star Wars: Jedi Knight: Jedi Academy

Primary Authentication: There may be possibility for setting username and password for media server which is offered in ‘Extra’ menu. Presently it helps authentication for under single person.

By Default, it would not use cookie based mostly authentication. It may be enabled by altering ‘MEDIA_SERVER_COOKIE’ subject to ‘True’, in ‘other_options.txt’ file. In cookie based mostly authentication, one cannot entry the media server instantly from regular participant. Customers want to make use of net browser to entry the media server. And as soon as playlist is generated from the browser, it may be performed by any media participant until the expiry of both cookies or playlist. Customers can individually set the expiry subject in hours for each cookies and playlist, within the ‘other_options.txt’ file. Default setting is 24 hours for each. If person will cease the server then playlist can be useless will not be usable any extra, in case of cookie based mostly authentication. Customers can even use curl or wget by way of command line with applicable fields for accessing media server playlists.

HTTPS Assist: It is attainable to allow HTTPS assist, with the assistance of self signed certificates. Customers can set ‘HTTPS_ON’ to ‘True’ within the other_options.txt. As soon as this subject is ready to True, the applying can generate self signed certificates mechanically in ‘pem’ format, if ‘openssl’ is put in and configured correctly on the system. The appliance will solely ask person to supply atleast eight character lengthy passphrase. And afterward it would generate ‘cert.pem’ file mechanically, which can be positioned in ‘~/.config/kawaii-player’ listing. Alternatively if person wish to generate self signed certificates on their very own, then they need to generate the certificates in ‘pem’ format and rename it as ‘cert.pem’ and should place within the config listing, for the applying to make use of whereas beginning the media server perform.

Issues with self-signed certificates: As soon as self-signed certificates is used, one has to entry the media server utilizing ‘https’ protocol as an alternative of ‘http’. And as soon as we do this, each browser will begin exhibiting safety warning to us. Due to this fact, customers want so as to add the certificates within the exemption record of the browser, with the intention to go to the media server. From the standpoint of encryption, there is no such thing as a distinction between self signed certicate and certificates signed by another authority. However Whereas browsing on the web, one ought to steer clear of websites utilizing self signed certificates, until you recognize what you might be doing.

Entry From Outdoors community: HTTPS assist was primarily added to facilitate safe entry of media server from outdoors the community. It’s attainable to entry the media server from outdoors the community, by setting ‘ACCESS_FROM_OUTSIDE_NETWORK’ to ‘True’. In an effort to use this function, person must know tips on how to do port forwarding. As soon as router is configured for port forwarding, all of the incoming requests to your router can be forwarded to native media server.

ACCESS_FROM_OUTSIDE_NETWORK subject has two parameters that are separated by colon. First parameter determines whether or not to permit entry from outdoors or not, and second parameter permits altering the frequency of requests to opendns for figuring out your public IP. Due to this fact this subject will look one thing like ‘ACCESS_FROM_OUTSIDE_NETWORK=True:5’, the place 5 refers to five hours. It means after each 5 hours, the applying will question opendns server to your public IP. In an effort to entry from outdoors the native community, one must know public IP tackle of our machine. The appliance determines it by accessing ‘https://diagnostic.opendns.com/myip‘ url, after sure particular interval determined by the person. A lot of the customers are allotted dynamic dns which is topic to vary, therefore it turns into essential to know public IP of our machine after some particular interval, to detemine whether or not IP tackle has modified or not.

Now the query is tips on how to get our modified IP tackle from outdoors the community? Now-a-days, most individuals have entry to some or different cloud service. The appliance can write modified IP tackle to any cloud based mostly file decided by person. The other_options.txt file comprises ‘CLOUD_IP_FILE’ subject, which must be set to any cloud based mostly file of any cloud based mostly service as per customers’ desire. Each time IP tackle of customers’ machine modifications, the applying will write the brand new IP tackle to the cloud file, which person can entry from any location.

In an effort to entry the server from outdoors the community, it’s essential to allow each cookies and password for server.

It’s attainable to entry the media server with plain ‘http’ protocol from outdoors the community, but it surely’s not advisable due to safety causes. Person should set ‘HTTPS_ON’ subject to ‘True’, in the event that they wish to entry media server from outdoors.

See also  VLC media player

Briefly, Recommanded settings for exterior entry to media server are as follows.

	(First set username and password from 'extra' menu after which make modifications in other_options.txt as beneath)

As soon as https enabled, customers will discover that many media gamers may not play playlist generated from the browser attributable to self signed certificates. From standard gamers, vlc,kodi,mplayer,mpv can play self signed https streams nicely, however nonetheless their taking part in means might range.

Word: Customers want to make use of separate port quantity for media server and torrent streaming function. Port quantity together with native IP for torrent streaming function must be set in ‘torrent_config.txt’ (TORRENT_STREAM_IP subject) and that of media server in ‘other_options.txt’ (LOCAL_STREAM_IP subject). Default Settings: ‘TORRENT_STREAM_IP=’ and ‘LOCAL_STREAM_IP=’. In default settings one cannot entry native media from one other laptop. Customers want to vary default loopback tackle to native ip tackle. Customers must set native IP tackle and port as soon as solely. If native IP tackle of the media server modifications dynamically subsequent time, then the kawaii-player software will attempt to discover out new tackle mechanically. If the applying cannot discover new tackle then customers must manually change the config recordsdata once more.

From v3.1 onwards all of those settings might be set from settings/preferene field of the applying. There isn’t a must fiddle with any of config recordsdata manually

Peer to Peer Mode


The moveable nature of media server permits the applying to work in peer to look mode. The pc operating the applying can behave as consumer in addition to server on the similar time. If two computer systems A and B are operating occasion of kawaii-player, then they will share their libraries in streaming mode with one another with out downloading domestically. This performance is offered from model 2.2+ onwards. This performance has been applied as a particular addon ‘MyServer’, which customers can discover within the Addons part.

Steps Inovolved in P2P mode for 2 computer systems:

  1. First add some objects within the library (by clicking on the library button) after which replace video and music part.

  2. Then verify and setup native IP tackle of each machines. (Extra->Settings)

  3. Change on media server performance on each. (Extra->Begin Media Server)

  4. Goto Addons->MyServer->Login

  5. Login requires IP tackle of the server that must be linked with (within the kind , if https is enabled for the server then write tackle accordingly). It’ll additionally ask for username and password. Customers can depart username/password subject clean if it has been not set for the server. As soon as the login is profitable message is displayed, click on on the login once more to navigate via library of server.

  6. It’s attainable for Media servers to broadcast themselves(Possibility is offered in extra menu), in order that different shoppers can uncover it mechanically by switching on their uncover performance (Addons->MyServer->Uncover: on consumer facet). On this case customers do not have to recollect the IP tackle of the server. Server can even ship customized broadcast message which will help shoppers to determine it correctly – if there are a number of servers operating. Shoppers can get record of servers within the software itself together with broadcast message, after that they should select which server to connect with. For safety causes server is allowed to broadcast itself solely within the native community.

  7. Broadcast Message must be entered into ‘BROADCAST_MESSAGE=’ subject in .config/kawaii-player/other_options.txt configuration file. If the sector isn’t there then create it on a newline.

  8. It’s attainable to setup add pace in KB for the server (The add pace can be similar for all linked shoppers). Proper click on on playlist (rightmost column), and choose ‘Set Add Velocity’. There isn’t a method to setup obtain pace – if the server is operating as a consumer of one other server. Streaming of media is dealt with by mpv/mplayer, therefore obtain pace cannot be managed externally.

  9. If person needs higher safety then activate HTTPS and cookies for each server by enhancing other_options.txt file. Username/password might be set from GUI itself from extra menu. Look into media server part for extra particulars.

  10. If consumer doesn’t wish to share its library and it simply wish to entry library of the server, then there is no such thing as a want for the consumer to change on its media server performance.

What’s the use case of p2p mode?

It permits customers to decentralize their assortment and on the similar time it permits straightforward sharing of media (in streaming mode) between a number of computer systems operating completely different working programs. This peer to look mode has been made just for private use inside community.

Common Playlist Era


Common playlist era is the by-product of the best way media server is applied on this software. Media server of this software, permits creation of playlist in both m3u or pls format, on the fly, which might be performed on any consumer supporting http streaming. (For extra particulars about playlist creation, see Media Server Part.) This playlist might be something from native audio, native video, some youtube urls, web radio stations or addon urls and even torrent streams, or any combine of varied media codecs. (Whereas creating playlist of blended media format and content material, torrent streams shouldn’t be blended with them. Torrent streams must be in separate playlist.) Because the playlist might be performed on any consumer which helps http streaming, customers do not need to connect themselves to explicit consumer software specified by media server for accessing their recordsdata. They will use any consumer of their alternative for taking part in playlist, from any platform.

Recommanded media gamers for taking part in playlist of blended content material: mpv,mplayer,vlc,kodi { or kawaii-player 🙂 }

For audio solely content material: audacious, clementine or any consumer that may play m3u recordsdata. (audacious can instantly learn metadata from streaming audio, therefore it is a lot better alternative for streaming audio)

On Android: vlc,kodi

Utilizing curl for getting media server playlist:

take into account media server ip:port mixture is

1. Getting present playlist and saving it as playlist.m3u.

	$ curl -L -o playlist.m3u

2. Getting present playlist with password enabled.
	$ curl -L --user username:password -o playlist.m3u
3. Looking out and getting customized playlist (e.g. From video class, search 'historical past' sub-section for 'mushishi' episodes):

	$ curl -L '' -o playlist.m3u
4. Getting playlist with cookie and password enabled.

	$ curl -L -c cookie.txt --user username:password {this command will set up session}
	$ curl -L -b cookie.txt --user username:password -o playlist.m3u {this command will get playlist}
5. Accessing server with https and password enabled:
	$ curl -L -k --user username:password -o playlist.m3u
6. Logout from terminal (with passwword, cookie and https enabled):
	$ curl -L -k --user username:password -b cookie.txt {This can take away session cookies and consumer IP tackle from server}

7. Getting playlist with curl and instantly taking part in it with mpv
	$ curl -L '' -o playlist.m3u && mpv playlist.m3u
8. Getting playlist with curl and instantly taking part in it with mplayer
	$ curl -L '' -o playlist.m3u && mplayer -playlist playlist.m3u

Playlist generated utilizing curl (or from net interface) might be opened with many of the desktop media gamers.

See also  Cyberpunk 2077 - GOG GALAXY's overlay and taking screenshots with F12

On Android units, person ought to use vlc newest nightly construct. vlc out there in fdroid could be very previous, and it is present secure android model can also be far behind desktop model in the case of taking part in community streams of all audio/video format. But it surely’s newest nightly construct model beginning with 2.1, can play many of the video codecs together with mkv/mp4 streams streamed by kawaii-player media server. It might additionally play streaming flac audio recordsdata. Presently it’s the finest open and free possibility out there for Android for taking part in audio/video media server recordsdata with out transcoding. Typically if it fails to play streaming recordsdata, then person can simply obtain these recordsdata on their Android gadget utilizing net interface. and may play the recordsdata natively.

One other standard open and free Android consumer is Kodi, which might additionally play many of the standard recordsdata over community with out transcoding, because it’s media playback engine is predicated on mplayer. However taking part in playlist instantly is considerably cumbersome in kodi. Kodi additionally don’t enable opening exterior url instantly. Due to this fact, customers first want to avoid wasting playlist domestically utilizing android net browser, after which want so as to add it is path to kodi’s music/video library. After updating kodi’s library, one can see m3u recordsdata in it is music/video library which customers can play with none extra problem.

Efficiency of vlc or kodi on android units additionally depends upon the {hardware} of the gadget. Relying on the {hardware} of cellular gadget, generally they could play each sort of community stream you throw at them, whereas generally they will not play even a easy video.

Word: As soon as person logs out from cookie and password enabled session, he/she will’t search something inside the server with out logging in once more. However the generated playlist might be performed by any participant until the expiry of playlist even after sign off. Expiry interval for playlist might be set in other_options.txt file (COOKIE_PLAYLIST_EXPIRY_LIMIT subject) in hours.

Torrent Streaming


It’s attainable to play audio/video torrent instantly with this participant just like any streaming media. By default the torrent will stream at, which is loop-back tackle of your native machine. Person can change this default streaming IP tackle to native ip tackle of their machine which usually begins with one thing like 192.168.x.y, (from settings/desire field), in the event that they wish to entry the torrent stream remotely.

In ‘torrent_config.txt’ you’ll be able to set another fields like add , obtain fee in (KBps) and default obtain location.

For opening torrents inside this participant, goto Addons->Torrent->Open and enter torrent file identify or torent url or magnet hyperlink contained in the enter dialog field, after which choose applicable entry which is able to seem in both Title record or Playlist. Your record of visited torrents can be accessible from the ‘Historical past’ part.

This function is predicated on libtorrent-rasterbar {which is being utilized by bittorrent shoppers like qBittorrent and deluge} and it is python3 bindings. If you happen to’ve put in newest model of libtorrent-rasterbar then python3 bindings are included together with it. In programs the place older model of libtorrent-rasterbar is put in, customers want to put in python3-libtorrent to make use of this function.

As soon as Torrent streaming will begin, a progress bar will seem to the suitable facet, which is able to present fundamental details about torrent.
If person will click on on this progress bar then they’ll get controls for stopping torrent and for setting add/obtain pace.

If torrent comprises a number of recordsdata then customers can enqueue the specified recordsdata by choosing applicable entry in Playlist column and urgent ‘key ctrl+q’.

Utilizing Internet Interface for managing and accessing Torrent Streaming server remotely:


(Previous Internet interface exhibiting operating of three torrents fetched from archive.org. One in all them being performed instantly within the browser. It means customers can ship some torrent http/magnet hyperlink from browser to the server, which can be then streamed again to the person)

First, arrange ip tackle and port correctly for each media server and torrent streaming in ‘other_options.txt’ and ‘torrent_config.txt’ recordsdata (Make it possible for port quantity is completely different in each the recordsdata. By default media server port is 9001 and that of torrent streaming server is 8001). Then begin media server and open net interface. In net ui, person will discover a textual content field for looking out media inside the server. This search field can be utilized for controlling torrent streaming on the media server with the assistance of textual content instructions. Following are the record of instructions which can be utilized for controlling behaviour of torrent:

1. For including torrent to the server, As soon as torrent data is fetched, it will likely be out there in *Torrent->Historical past* part

$ torrent:torre

Leave a Reply

Your email address will not be published.