Skip to content

Commit b034f1f

Browse files
authored
Update README.md
1 parent e472873 commit b034f1f

1 file changed

Lines changed: 42 additions & 30 deletions

File tree

README.md

Lines changed: 42 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
1-
HackDVB GUI
1+
# **HackDVB GUI**
22

33
A user-friendly graphical interface for creating and broadcasting DVB-S/S2 transport streams using FFmpeg, TSDuck, and DekTec hardware.
44

55
HackDVB GUI is the spiritual digital successor to the analogue HackTV project. It provides a comprehensive suite of tools to encode media files, multiplex them into multiple services (channels), generate the necessary DVB tables (including a full EPG), and broadcast the resulting stream with a DekTec modulator card.
66

7-
Features
7+
## **Features**
88
HackDVB GUI is designed to simplify the complex process of DVB broadcasting by providing a powerful, all-in-one interface.
99

10-
Core Broadcasting Features
10+
## **Core Broadcasting Features**
1111
Multi-Service Multiplexing: Create multiple TV and Radio channels within a single broadcast stream.
1212
Hardware-Accelerated Encoding: Offload CPU-intensive tasks to your GPU with support for NVIDIA CUDA (NVENC) and Intel Quick Sync Video (QSV).
1313
Advanced Encoding Options: Full control over video/audio codecs (MPEG-2, H.264, MP2, AC3, AAC), bitrates, presets, resolutions, framerates, and more.
1414
DVB-S & DVB-S2 Support: Configure all necessary transmission parameters, including modulation, FEC, symbol rate, and frequency, with an automatic Mux Rate calculator.
1515
Comprehensive Input Support: Use single media files, FFmpeg concat playlists, user-friendly managed playlists, or live UDP/IP streams as sources.
16+
1617
Full EPG Management:
1718
A powerful EPG Editor to create, edit, and manage your broadcast schedule.
1819
Auto-generate EPG from media file durations, complete with metadata options.
@@ -22,6 +23,7 @@ Burn-in: Permanently render external .srt or .ass subtitles onto the video.
2223
DVB Subtitles: Pass through embedded subtitle tracks from the source file for viewer-toggleable subtitles.
2324
Audio Control: Select multiple audio tracks from your source files for multi-language broadcasts and apply EBU R128 loudness normalization for consistent volume.
2425
Utility & Workflow
26+
2527
Standalone Media Tools: A dedicated "Tools" tab for batch processing files:
2628
Video Converter: Re-encode files to standard formats.
2729
Remux to TS: Quickly repackage .mp4 or .mkv files into a .ts container without re-encoding.
@@ -31,35 +33,45 @@ Live Previews: See the generated ffmpeg and tsp commands update in real-time as
3133
Detailed Logging: View live log output from all backend processes to monitor performance and troubleshoot errors.
3234
Save & Load Configurations: Save your entire session—all channels, inputs, and settings—to a single JSON file and load it back later.
3335
Built-in Documentation: An in-app wiki provides detailed explanations of every feature and the underlying technologies.
34-
How It Works
36+
37+
## **How It Works**
3538
HackDVB GUI acts as an orchestrator for several powerful command-line tools, piping the output of one to the input of the next:
3639

37-
FFmpeg: Handles all media decoding, filtering (subtitles, loudnorm), and re-encoding. It creates a compliant MPEG Transport Stream (MPEG-TS) containing all the video and audio for your services.
38-
TDT Injector (tdt.exe): A small companion utility that generates TDT/TOT packets, which are essential for a receiver's clock to synchronize and display EPG data correctly.
39-
TSDuck (tsp): Receives the stream from FFmpeg and performs the final muxing. It injects critical DVB Service Information (SI) tables (like NIT, SDT), injects the EPG data (EIT) from the generated XML file, and merges the time packets from the TDT Injector.
40-
DekTec Hardware: TSDuck outputs the final, constant-bitrate transport stream to the DekTec modulator card, which converts the digital stream into a real RF signal for broadcast.
41-
Requirements
42-
Hardware
43-
A DekTec DVB-S/S2 Modulator Card (e.g., DTA-2111) with an available PCIe slot.
44-
CPU: A modern multi-core CPU (Intel Core i5/i7, AMD Ryzen 5 or better) is recommended, especially for multi-channel or HD encoding.
45-
GPU (Optional but Recommended): An NVIDIA GPU (GTX 1050 or newer) or an Intel CPU with an integrated GPU is highly recommended for hardware-accelerated encoding.
46-
RAM: 8 GB minimum, 16 GB+ recommended.
47-
Software
48-
Python 3.x
49-
FFmpeg: Must be installed and available in your system's PATH.
50-
TSDuck: Must be installed and available in your system's PATH.
51-
TDT Injector (tdt.exe): This utility should be included with the application.
52-
The application includes a startup dependency checker that will guide you if any of these are missing.
53-
54-
Usage
55-
Services Tab: Click "Add Channel" to create a new service. Give it a name, provider, and a unique Program Number (SID).
56-
Inputs Tab: For each service, select an input type (e.g., Playlist) and add your media files. Use the "Probe Input Tracks" button to detect and select specific audio or embedded subtitle tracks.
57-
EPG (Optional): Use the "Auto-generate EPG" button for a quick schedule, or open the "Create/Edit EPG" editor for full control.
58-
Encoding & Muxing Tab: Configure your global video and audio settings. Enable CUDA or QSV if you have compatible hardware.
59-
DVB Broadcast Tab: Enter the parameters for your satellite transponder (Frequency, Symbol Rate, etc.) and click "Auto-Calculate" for the Mux Rate.
60-
Start Broadcast: Click the "Start Broadcast" button to begin transmission! Monitor the "Live Log" for status and errors.
61-
A Note on Encryption
40+
* **FFmpeg:** Handles all media decoding, filtering (subtitles, loudnorm), and re-encoding. It creates a compliant MPEG Transport Stream (MPEG-TS) containing all the video and audio for your services.
41+
* **TDT Injector (tdt.exe):** A small companion utility that generates TDT/TOT packets, which are essential for a receiver's clock to synchronize and display EPG data correctly.
42+
* **TSDuck (tsp):** Receives the stream from FFmpeg and performs the final muxing. It injects critical DVB Service Information (SI) tables (like NIT, SDT), injects the EPG data (EIT) from the generated XML file, and merges the time packets from the TDT Injector.
43+
* **DekTec Hardware:** TSDuck outputs the final, constant-bitrate transport stream to the DekTec modulator card, which converts the digital stream into a real RF signal for broadcast.
44+
45+
## **Requirements**
46+
47+
**Hardware**
48+
49+
* A **DekTec DVB-S/S2 Modulator Card (e.g., DTA-2111) with an available PCIe slot.**
50+
* **CPU:** A modern multi-core CPU (Intel Core i5/i7, AMD Ryzen 5 or better) is recommended, especially for multi-channel or HD encoding.
51+
* **GPU (Optional but Recommended):** An NVIDIA GPU (GTX 1050 or newer) or an Intel CPU with an integrated GPU is highly recommended for hardware-accelerated encoding.
52+
* **RAM:** 8 GB minimum, 16 GB+ recommended.
53+
54+
55+
**Software**
56+
57+
* **OS: Windows 10 or 11 64-Bit**
58+
* **Python 3.x**
59+
* **FFmpeg: Must be installed and available in your system's PATH.**
60+
* **TSDuck: Must be installed and available in your system's PATH.**
61+
* **TDT Injector (tdt.exe): This utility should be included with the application.**
62+
* **The application includes a startup dependency checker that will guide you if any of these are missing.**
63+
64+
## **Usage**
65+
66+
* **Services Tab:** Click "Add Channel" to create a new service. Give it a name, provider, and a unique Program Number (SID).
67+
* **Inputs Tab:** For each service, select an input type (e.g., Playlist) and add your media files. Use the "Probe Input Tracks" button to detect and select specific audio or embedded subtitle tracks.
68+
* **EPG (Optional):** Use the "Auto-generate EPG" button for a quick schedule, or open the "Create/Edit EPG" editor for full control.
69+
* **Encoding & Muxing Tab:** Configure your global video and audio settings. Enable CUDA or QSV if you have compatible hardware.
70+
* **DVB Broadcast Tab:** Enter the parameters for your satellite transponder (Frequency, Symbol Rate, etc.) and click "Auto-Calculate" for the Mux Rate.
71+
* **Start Broadcast:** Click the "Start Broadcast" button to begin transmission! Monitor the "Live Log" for status and errors.
72+
73+
**A Note on Encryption**
6274
This application is designed for educational and experimental broadcasting of unencrypted, free-to-air content only. It does not support or include any features for scrambling the broadcast stream with a Conditional Access (CA) system.
6375

64-
*License
76+
## **License**
6577
This project is licensed under the MIT License. See the LICENSE file for details.

0 commit comments

Comments
 (0)