CyberTelly

Go back


CyberTelly Qt - User Manual


Content:

  1. Keyboard Shortcuts
  2. Mouse Control
  3. How to set up your TV environment
  4. Troubleshooting
  5. System Requirements
  6. Information for Developers
  7. Copyright and Licensing

Keyboard Shortcuts:

Key Action
Ctrl-P Open channel list
Double Click or Enter starts streaming selected channel
P Start streaming
S Stop streaming
Ctrl-V Switch to Fullscreen
ESC Switch back from Fullscreen
Ctrl-T Show / hide Toolbar
Ctrl-9 Set Aspect Ratio to 16:9
Ctrl-L Set Volume
Space Bar Audio muted / unmuted
Arrow up Volume up
Arrow down Volume down
Ctrl-E Open Settings Dialog
F1 Show Help Dialog
Ctrl-I Show About Dialog

Mouse Control:

How to … Steps how to do it
open the context menu Position cursor inside the window
Click right mouse button
move the window Position cursor inside the window
Left mouse button + Drag & Drop
resize the window Move cursor to the right bottom corner
Left mouse button + Drag & Drop
turn fullscreen on or off Position cursor inside the window
Double click left mouse button
adjust volume quickly Position cursor inside the window
Turn mouse wheel
display EPG (TVHeadend only) Open channel list
Move cursor to the desired channel
After a short delay tooltip pops up
Tooltip has four entries

How to set up your TV environment:

Download urls for IPTV m3u playlists:

https://github.com/jnk22/kodinerds-iptv
https://github.com/iptv-org/iptv (PLAYLISTS.md)
Where to save the playlists: Folder CyberTelly/m3u in Linux Home Dir or C:\Users[user name]

How to create your own m3u playlist:

Make sure you have downloaded m3u lists
How to build your own list:

  1. Open downloaded lists in file manager
  2. Open VLC Player
  3. Menu: View Playlist
  4. Drag m3u lists into playlist window
  5. Delete channels you don't like (Del)
  6. Rearrange channel order (Drag & Drop)
  7. Right click: Save playlist
    Where to save it: Folder CyberTelly/m3u in Linux Home Dir or C:\Users\[user name]

Fritzbox-Cable - How to create m3u list:

  1. Open VLC media player
  2. Menu View-Playlist-Universal Plug'n'Play
    Media servers show up
    Double click opens channel list
  3. Drag & Drop: Channels > Playlist
  4. Open Playlist window
  5. Drag & Drop: Rearrange channels
  6. Right click: Save playlist
    Where to save it: Folder CyberTelly/m3u in Linux Home Dir or C:\Users\[user name]

Sat>IP Server - How to create m3u list

M3u playlists also work with Sat>IP servers, similar to a FritzBox-Cable. Almost ready to use m3u playlists can be downloaded from:
https://github.com/dersnyke/satipplaylists
After the download open the list with a text editor and replace ‘sat.ip’ with the ip address of the server.
Example: sat.ip > 192.168.178.230
If you like you can customize and store your playlist then as described above.
This procedure was successfully tested with a Megasat Sat>IP server.

TVHeadend Server HowTo:

A TVHeadend server usually runs in the local network and serves as a source for streaming and recording live TV.
Possible Hardware: Raspi 4 with TV HAT and Raspi OS lite
For more Information see: https://tvheadend.org

How to access the THV-Server:

   
Url [Protocol][Server IP]:[Port]
Protocol http://
Server IP IPv4-Address of TVH server
Port 9981 (TVHeadend default)
Example http://192.168.178.235:9981

The example above can be used as a blue print for the input in the settings dialog.

User Settings TVHeadend:

Menu item: Configuration-Users-Access Entries
Menu item: Configuration-Users-Passwords

Authentication Settings TVHeadend:

   
Menu item Configuration-General-Base
Http Server Settings
Authentication type Plain (insecure)
Digest hash type MD5

Please note:
CyberTelly only works with correct user and authentication settings!

EPG:

EPG doesn’t work with m3u playlists.

Troubleshooting:

Known Issues:

For detailed troubleshooting instructions see Troubleshooting.txt

System Requirements:

Operating System:

Windows 10 / 11: tested, ok

Linux x64 (wayland and x11): ok

Different distribution types need special minimum versions of the GNU C Library (glibc) to be able to run the program:

How to determine the glibc version:

  1. Open Linux shell
  2. Type in: ldd --version

In case of a glibc version mismatch, CyberTelly can be installed, but not started.

For more information see: InstallationGuide.txt

Raspberry Pi OS 64Bit (wayland and x11):

MacOS: Should be possible, but isn't implemented

Due to a lack of Apple hardware, CyberTelly could not be tested and deployed.

VLC Media Player Version 3

Windows: Version >= 3.0.21

Linux: Version >= 3.0.20

Hint for Linux Snap/Flathub installations:
VLC must be set up from the distibution repository. Snap or Flathub apps are running in a sandbox where the access to the VLC library (libvlc) is blocked.

Information for Developers

CyberTelly was developed using Python along with python-vlc and PySide6, the Python bindings for VLC and the Qt6 framework. Everybody who is interested in getting an idea how it works, can have a look at the source code: Set up a virtual Python environment, install the required modules using requirements.txt and start coding!

The program deployment is not part of this publication. Information on that can be looked up in the following book: Fitzpatrick Martin, Create GUI Applications with Python & Qt6 (5th Edition, PyQt6), p. 651ff.

Copyright and Licensing:

Copyright (C) 2025 Rudolf Ringel
This program is free software. It is licensed under the terms of the GNU General Public License 3 (GPLv3). It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
For more information see: https://www.gnu.org/licenses/