How to set up LayerSeven TV on Linux
Linux is well served here, and if you already live in a terminal none of this will surprise you. We ship a .deb for Debian and Ubuntu and an AppImage that runs anywhere else without installing at all. VLC, which is on practically every desktop already, will also play your subscription — it just will not give you a guide.
devicesSelect Your Device
checklistBefore you start
- A 64-bit Linux desktop — Ubuntu 20.04 or newer, or equivalent
- Your username, password and server URL from the subscription email
- Permission to install packages (sudo), unless you use the AppImage
Step-by-Step Setup
Linux Installation
Download LayerSeven TV Player
From our Downloads page, take the .deb if you are on Ubuntu, Debian, Mint or another Debian derivative, and the AppImage for Fedora, Arch, openSUSE or anything else. The AppImage needs no installation and no root, which is useful on a machine you do not administer.
Install the Application
For the .deb, open a terminal in the download folder and run "sudo dpkg -i layerseven-tv.deb", then "sudo apt-get install -f" to pull in anything missing. For the AppImage, make it executable — right-click > Properties > Permissions > Allow executing as program, or chmod +x from the terminal — then run it directly.
Login with Your Credentials
Open the app and enter the username and password from your subscription email; it activates for free. With VLC instead, go to Media > Open Network Stream and paste your M3U URL. VLC plays everything but has no concept of an EPG, so you get channels without a guide.
Check Hardware Decoding
On a desktop with a discrete GPU this rarely matters; on a laptop or a small-board machine it matters a great deal. Make sure VA-API or VDPAU acceleration is enabled in the player and that the matching driver package is installed, or 4K playback falls back to the CPU and stutters.
Start Streaming
Channels, guide, films and series all load as they do elsewhere. Everything runs equally well under X11 and Wayland.
Connection Formats
Supported formats for Linux
Xtream Codes API
Enter Server URL, Username & Password. Most recommended method for ease of use.
M3U Playlist
Paste the M3U/M3U8 URL directly into your player. Universal compatibility.
Recommended Apps
Best players for Linux
LayerSeven TV
Our official player — best experience guaranteed
VLC Media Player
Open-source universal media player
Common problems
Fixes specific to Linux
dpkg complains about dependencies
Expected — dpkg does not resolve them itself. Run "sudo apt-get install -f" straight after and it will fetch what is missing and finish the install. There is no need to run dpkg again.
The AppImage will not start
It is almost certainly not executable yet: run chmod +x against the file. On some minimal installs you may also need FUSE — "sudo apt install libfuse2" on Ubuntu.
Video tears or stutters on a laptop
Hardware decoding is not active. Install the VA-API driver for your chip — intel-media-va-driver, mesa-va-drivers or the NVIDIA equivalent — and enable acceleration in the player.
Need Help Setting Up?
Our support team is available 24/7 to guide you through the installation process via live chat.