A simple app meant to be run in background. Automates the process of receiving cast media over the local network. Install it on device with any Linux DE to turn your media player into receiver that plays files cast with Cast to TV from your host PC.
To receive media set
Playercast app as your receiver type in Cast to TV settings.
Only compatible with Cast to TV v10+.
- Receives all types media from Cast to TV
- Automatically starts media player upon cast
- Can be installed on any Linux distro with any DE
- Remotely control playback from GNOME top bar
- Supports HDMI-CEC
- Safe to use (does not use
sudo npm install -g playercast
Requires one of the supported media players to work.
Currently only MPV player is supported. VLC support is planned for the future.
The application can be used from terminal with:
IP is the address of server PC with Cast to TV extension.
PORT is the listening port set in Cast to TV extension settings (default: 4000).
By default Playercast receiver name is autogenerated as
Custom name can be assigned with
playercast IP:PORT --name 'Raspberry Pi'
Select Playercast name in Cast to TV settings
Other tab to control which of your devices receives media.
Install as systemd service
After testing in command line, app can be installed as systemd service with:
playercast IP:PORT --name 'Bedroom TV' --create-service
Above command can always be run again to update configuration with new device name, address or other args.
Remember to enable and start newly added service with:
systemctl --user enable playercast systemctl --user start playercast
App will be running on each system boot as background service idling and waiting to receive cast files.
It is recommended to assign your server PC a static IP address, otherwise app will not be able to connect when IP changes.
If you want to completely remove systemd service run:
systemctl --user disable playercast systemctl --user stop playercast playercast --remove-service
Requires CEC capable device (e.g. Raspberry Pi) and TV with such functionality.
cec-client must be installed. On Raspbian it is included in
sudo apt install cec-utils
CEC functionality is automatically detected and enabled on app launch.
It can be disabled with
Raspberry Pi marks HDMI port as active during startup, which means that TV source will not be switched automatically on first media cast after system boot.
Switch HDMI after playback
When playback is finished, HDMI port will be marked as inactive. This causes some TVs to switch input source to another one.
If you want to always switch TV to one of available HDMI ports after playback use
--cec-end-hdmi option followed by a number of the HDMI port.
TV Remote buttons keymap
Default keymap for controlling media player with TV remote.
`Up` - switch video track `Play` - play `Down` - switch audio track `Pause` - pause `Left` - previous item in playlist `Rewind` - seek backward 10 sec `Right` - next item in playlist `Fast forward` - seek forward 10 sec `Select` - cycle fullscreen `Exit`/`Stop` - stop player `Subtitle` - switch subtitles
Alternative buttons keymap
Alternative keymap can be enabled with
`Up` - next item in playlist `Select` - cycle pause `Down` - previous item in playlist `Play` - play `Left`/`Rewind` - seek backward 10 sec `Pause` - pause `Right`/`Fast forward` - seek forward 10 sec `Exit`/`Stop` - stop player `Red` - switch video track `Green` - switch audio track `Yellow`/`Subtitle` - switch subtitles `Blue` - cycle fullscreen
If you like my work please support it by buying me a cup of coffee :-)