Add APT repository installation option to DEBIAN.md

[vejeta]

Add APT repository installation option to DEBIAN.md

Summary

Adds an APT repository installation method to DEBIAN.md, providing users with an easy alternative to building from source. This addresses common compilation issues reported in the community while maintaining all existing build documentation.

New APT Repository Installation (Recommended)

wget -qO - https://debian.vejeta.com/key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/stremio-debian.gpg
echo "deb [signed-by=/usr/share/keyrings/stremio-debian.gpg] https://debian.vejeta.com trixie main non-free" | sudo tee /etc/apt/sources.list.d/stremio.list
sudo apt update
sudo apt install stremio stremio-server

Also, this package has been officially submitted to Debian, following highest standards, and updated for bookworm, trixie, testing, sid (or Kali Linux), and Ubuntu Noble, fixing many problems people have been finding across the years with the current package provided by Stremio that is not Debian compliant or references non-existant dependencies (libmpv1)

Benefits:

• ✅ No compilation needed
• ✅ Automatic dependency resolution
• ✅ Automatic updates via apt upgrade
• ✅ GPG signed packages
• ✅ Proper system integration

Available packages:

• stremio - Desktop client (GPL-3.0, required)
• stremio-server - Streaming server (proprietary, optional but recommended)

Testing & Compatibility

Tested and working on:

• ✅ Debian 13 (Trixie)
• ✅ Debian 12 (Bookworm)
• ✅ Debian Testing
• ✅ Debian Sid / Kali Linux
• ✅ Should work on Ubuntu 22.04+ (community testing welcome)

Each distribution gets native packages with correct dependencies.

Key Improvements

1. Modern Security Practices

• Uses gpg --dearmor instead of deprecated apt-key
• Proper GPG keyring location (/usr/share/keyrings/)
• Signed packages for verification

2. Complete Dependency Documentation

Instead of discovering missing dependencies through error messages, all required packages are now listed upfront:

Build dependencies:

qtcreator qt5-qmake qt5-qmake-bin g++ pkgconf
qtbase5-dev qtdeclarative5-dev qtwebengine5-dev qttools5-dev
libmpv-dev libssl-dev librsvg2-bin nodejs npm

QML runtime modules:

qml-module-qtwebchannel qml-module-qt-labs-platform
qml-module-qtwebengine qml-module-qtquick-dialogs
qml-module-qtquick-controls qml-module-qt-labs-settings
qml-module-qt-labs-folderlistmodel

3. Better Organization

Restructured documentation as:

• Option 1: APT Repository (Recommended) - For most users
• Option 2: Build from Source - For developers/customization
• Building Debian Packages - For proper packaging
• Known Issues & Solutions - Common problems addressed
• Contributing - How to participate

4. Official Debian Packaging Reference

The APT repository packages are maintained as part of the official Debian packaging effort:

• ITP (Intent To Package): https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=943703
• Canonical sources: https://salsa.debian.org/mendezr/stremio (main) and stremio-server (non-free)
• Status: Packages currently under review for submission to official Debian archive

Backward Compatibility

All existing build instructions remain valid and unchanged. This PR only adds new options and improves clarity - no existing workflows are broken.

Community Impact

This change addresses numerous installation issues reported by users struggling with build dependencies and compilation errors on modern Debian systems. The APT repository provides an immediate solution while preserving the educational value of the build-from-source documentation.

Related Links

• APT Repository: https://debian.vejeta.com
• GitHub Project: https://github.com/vejeta/stremio-debian
• Salsa Repositories: https://salsa.debian.org/mendezr/stremio and stremio-server
• ITP Bug: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=943703

---

This improvement provides users with a much easier installation path while maintaining comprehensive documentation for building from source. The APT repository method is now the recommended approach for Debian-based systems.

CC: @core1024 for visibility