M3U Converter Studio v4

M3U Converter Studio is a professional desktop tool for managing, editing, and converting IPTV playlists. It supports **M3U**, **M3U8**, **M3U Plus**, and **TXT** formats

linuxsat-support.com/cms/attachment/348694/linuxsat-support.com/cms/attachment/348695/linuxsat-support.com/cms/attachment/348696/

############### ENGLISH ###############

# 📖 M3U Converter Studio – User Guide

> **Version:** 4.0 Pro | **Languages:** 🇩🇪 Deutsch, 🇬🇧 English

---

## 🚀 What is M3U Converter Studio?

M3U Converter Studio is a professional desktop tool for managing, editing, and converting IPTV playlists. It supports **M3U**, **M3U8**, **M3U Plus**, and **TXT** formats, and includes a built-in media player, picon display, and extensive editing capabilities.

---

## 📂 1. List Management (Tab: "Lists")

### Loading a File

- Click **📂 Select File** in the sidebar or the upload button

- Supported formats: `.m3u`, `.m3u8`, `.txt`

- Alternatively: **Drag & Drop** a file into the upload area

### Loading from the Internet

- Click **🌐 Load Online Link** in the sidebar

- Enter an M3U/IPTV URL

- The playlist is automatically downloaded and parsed

### Managing Groups

| Action | Description |

|--------|-------------|

| **New Group** | Click "󰐕 New Group" below the group list |

| **Rename Group** | Right-click on group → "✏️ Rename" |

| **Delete Group** | Right-click on group → "🗑 Delete" |

| **Move Group** | Arrow buttons ⬆️⬇️ below the group list |

| **Search Group** | Use the search field above the group list |

| **Save Group** | "💾 Save Group" – exports all streams of a group as M3U/M3U8/M3U Plus |

### Managing Streams

| Action | Description |

|--------|-------------|

| **Select Stream** | Click on a stream in the list |

| **Rename Stream** | Right-click → "✏️ Rename" |

| **Delete Stream** | Right-click → "🗑 Delete" |

| **Move Stream** | Right-click → "📦 Move to group..." |

| **Reorder** | Arrow buttons ⬆️⬇️ below the stream list |

| **Multi-select** | `Ctrl` + Click to select multiple streams |

| **Search Channel** | Use the search field above the stream list |

---

## ▶️ 2. Built-in Media Player

### Playing a Stream

1. Select a stream from the list

2. Click **▶️ Play**

3. The video is displayed in the built-in player

### Playback Controls

| Button | Function |

|--------|----------|

| **▶️ Play** | Starts playback |

| **⏹️ Stop** | Stops playback |

| **🔊 Audio On** | Enables audio |

| **🔇 Audio Off** | Mutes audio |

### Playback Modes

- **VLC Internal** – Plays the stream in the built-in player

- **Open External** – Opens the stream in VLC Media Player or the default browser

---

## 🖼️ 3. Picon Display (Channel Logos)

### What are Picons?

Picons are small channel logos displayed next to each stream.

### Setting Up Local Picons

1. Click the **🖼️ icon** in the header bar

2. Select the folder containing your picon images (`.png`, `.jpg`)

3. Picons are automatically matched to channels

### Automatic Online Search

If no local picon is found, the tool automatically searches online sources:

- First, the `tvg-logo` attribute from the M3U file is loaded

- Then online picon databases are searched

---

## 📝 4. Text Editor (Tab: "Edit Text")

### Loading a Text File

1. Switch to the **📝 Edit Text** tab

2. Click **󰈦 Open File**

3. Select a `.txt` file containing links/URLs

### Editing Features

| Button | Function |

|--------|----------|

| **󰆴 Remove** | Deletes selected entries |

| **✏️ Edit** | Edits the selected entry |

| **📋 Delete Duplicates** | Automatically removes duplicate entries |

---

## 🔄 5. Converter (Tab: "Converter")

The converter transforms URLs and text content into various playlist formats.

### Converting Text

1. Switch to the **🔄 Converter** tab

2. Load a `.txt` file or paste URLs directly

3. Choose the target format:

- **🚀 to m3u** – Standard M3U format

- **🚀 to m3u8** – M3U8 format (for HLS streams)

- **🚀 to m3u_plus** – Extended format with `tvg-name` and `group-title`

4. Choose a save location

### URL-based Conversion

1. Highlight a URL in the text field

2. Click one of the convert buttons

3. The tool downloads the playlist from the URL and converts it automatically

4. IPTV API URLs are detected and the `type=` / `output=` parameters are adjusted based on the target format

### Supported Input Formats

The tool automatically recognizes various text formats:

- Plain URLs (one per line)

- `Name, URL` (comma-separated)

- `Name; URL` (semicolon-separated)

- `Name | URL` (pipe-separated)

---

## 🩹 6. Doctor – Cleanup

The **Doctor** automatically analyzes and cleans your loaded playlist.

### Cleanup Steps

1. **Remove Duplicates** – Streams with the same URL are removed

2. **Remove Empty URLs** – Streams without a URL are deleted

3. **Remove Invalid URLs** – Only URLs starting with `http://` or `https://` are kept

4. **Clean Channel Names** – Excess whitespace and special characters are removed

5. **Remove Empty Groups** – Groups without streams are deleted

### How to Use

1. Load an M3U file

2. Click **🩹 Clean Up** in the sidebar

3. A summary shows how many streams were removed

---

## 🌐 7. Language Switching

The tool supports **German** and **English**:

- Click **🇩🇪** for German

- Click **🇬🇧** for English

- All UI texts, dialogs, and messages are updated instantly

---

## 📊 8. Status Bar

At the bottom of the application you can always see:

- 📄 Name of the loaded file

- 📺 Number of streams

- 📂 Number of groups

- 📋 Number of duplicates

- ● Autosave status

---

## ⌨️ 9. Tips & Tricks

> **Tip 1:** Use the search fields to quickly find channels in large playlists.

> **Tip 2:** Right-click on streams to select multiple and move them to another group.

> **Tip 3:** Run the Doctor after every new playlist import to keep your list clean.

> **Tip 4:** Picon folders should contain images named `CHANNELNAME.png` or `CHANNELNAME.jpg` (uppercase, underscores instead of spaces).

> **Tip 5:** IPTV URLs in the converter can be highlighted and automatically adjusted with the `type=` parameter.

---

## 🔧 10. System Requirements

- **Operating System:** Windows 10/11

_**vlc player must be installed on your system

*M3U Converter Studio v4 Pro

##############################################################

############### GERMAN ###############

# 📖 M3U Converter Studio – Benutzerhandbuch

> **Version:** 4.0 Pro | **Sprachen:** 🇩🇪 Deutsch, 🇬🇧 English

---

## 🚀 Was ist M3U Converter Studio?

M3U Converter Studio ist ein professionelles Desktop-Tool zur Verwaltung, Bearbeitung und Konvertierung von IPTV-Playlisten. Es unterstützt die Formate **M3U**, **M3U8**, **M3U Plus** und **TXT** und bietet einen integrierten Mediaplayer, Picon-Anzeige sowie umfangreiche Bearbeitungsfunktionen.

---

## 📂 1. Listen-Verwaltung (Tab: "Listen")

### Datei laden

- Klicken Sie auf **📂 Datei auswählen** in der Seitenleiste oder auf den Upload-Button

- Unterstützte Formate: `.m3u`, `.m3u8`, `.txt`

- Alternativ: Datei per **Drag & Drop** in den Upload-Bereich ziehen

### Internet-Link laden

- Klicken Sie auf **🌐 Internet Link laden** in der Seitenleiste

- Geben Sie eine M3U/IPTV-URL ein

- Die Playlist wird automatisch heruntergeladen und geparst

### Gruppen verwalten

| Aktion | Beschreibung |

|--------|-------------|

| **Neue Gruppe** | Klicken Sie auf „󰐕 Neue Gruppe" unter der Gruppenliste |

| **Gruppe umbenennen** | Rechtsklick auf Gruppe → „✏️ Umbenennen" |

| **Gruppe löschen** | Rechtsklick auf Gruppe → „🗑 Löschen" |

| **Gruppe verschieben** | Pfeiltasten ⬆️⬇️ unter der Gruppenliste |

| **Gruppe suchen** | Suchfeld über der Gruppenliste nutzen |

| **Gruppe speichern** | „💾 Gruppe speichern" – exportiert alle Streams einer Gruppe als M3U/M3U8/M3U Plus |

### Streams verwalten

| Aktion | Beschreibung |

|--------|-------------|

| **Stream auswählen** | Klicken Sie auf einen Stream in der Liste |

| **Stream umbenennen** | Rechtsklick → „✏️ Umbenennen" |

| **Stream löschen** | Rechtsklick → „🗑 Löschen" |

| **Stream verschieben** | Rechtsklick → „📦 In Gruppe verschieben..." |

| **Reihenfolge ändern** | Pfeiltasten ⬆️⬇️ unter der Stream-Liste |

| **Mehrfachauswahl** | Mit `Strg` + Klick mehrere Streams markieren |

| **Sender suchen** | Suchfeld über der Stream-Liste nutzen |

---

## ▶️ 2. Integrierter Mediaplayer

### Stream abspielen

1. Wählen Sie einen Stream aus der Liste

2. Klicken Sie auf **▶️ Abspielen**

3. Das Video wird im integrierten Player angezeigt

### Wiedergabe-Optionen

| Button | Funktion |

|--------|----------|

| **▶️ Abspielen** | Startet die Wiedergabe |

| **⏹️ Stoppen** | Stoppt die Wiedergabe |

| **🔊 Audio An** | Aktiviert den Ton |

| **🔇 Audio Aus** | Schaltet den Ton stumm |

### Wiedergabemodus

- **VLC Intern** – Spielt den Stream im eingebauten Player ab

- **Extern öffnen** – Öffnet den Stream in VLC Media Player oder dem Standard-Browser

---

## 🖼️ 3. Picon-Anzeige (Senderlogos)

### Was sind Picons?

Picons sind kleine Senderlogos, die neben jedem Stream angezeigt werden.

### Lokale Picons einrichten

1. Klicken Sie auf das **🖼️ Symbol** in der Kopfzeile

2. Wählen Sie den Ordner aus, in dem Ihre Picon-Bilder (`.png`, `.jpg`) liegen

3. Die Picons werden automatisch den Sendern zugeordnet

### Automatische Online-Suche

Wenn kein lokales Picon gefunden wird, sucht das Tool automatisch in Online-Quellen:

- Zuerst wird das `tvg-logo` aus der M3U-Datei geladen

- Dann wird in Online-Picon-Datenbanken gesucht

---

## 📝 4. Text-Editor (Tab: "Text bearbeiten")

### Textdatei laden

1. Wechseln Sie zum Tab **📝 Text bearbeiten**

2. Klicken Sie auf **󰈦 Datei öffnen**

3. Wählen Sie eine `.txt` Datei mit Links/URLs

### Bearbeitungsfunktionen

| Button | Funktion |

|--------|----------|

| **󰆴 Entfernen** | Löscht ausgewählte Einträge |

| **✏️ Bearbeiten** | Bearbeitet den ausgewählten Eintrag |

| **📋 Duplikate löschen** | Entfernt doppelte Einträge automatisch |

---

## 🔄 5. Konverter (Tab: "Konverter")

Der Konverter wandelt URLs und Textinhalte in verschiedene Playlist-Formate um.

### Text konvertieren

1. Wechseln Sie zum Tab **🔄 Konverter**

2. Laden Sie eine `.txt` Datei oder fügen Sie URLs direkt ein

3. Wählen Sie das Zielformat:

- **🚀 zu m3u** – Standard M3U-Format

- **🚀 zu m3u8** – M3U8-Format (für HLS-Streams)

- **🚀 zu m3u_plus** – Erweitertes Format mit `tvg-name` und `group-title`

4. Wählen Sie einen Speicherort

### URL-basierte Konvertierung

1. Markieren Sie eine URL im Textfeld

2. Klicken Sie auf eines der Konvertier-Buttons

3. Das Tool lädt die Playlist von der URL herunter und konvertiert sie automatisch

4. IPTV-API-URLs werden erkannt und der `type=` / `output=` Parameter wird je nach Zielformat angepasst

### Unterstützte Eingabeformate

Das Tool erkennt verschiedene Textformate automatisch:

- Reine URLs (eine pro Zeile)

- `Name, URL` (kommagetrennt)

- `Name; URL` (semikolongetrennt)

- `Name | URL` (pipe-getrennt)

---

## 🩹 6. Doctor – Bereinigung

Der **Doctor** analysiert und bereinigt Ihre geladene Playlist automatisch.

### Bereinigungsschritte

1. **Duplikate entfernen** – Streams mit gleicher URL werden entfernt

2. **Leere URLs entfernen** – Streams ohne URL werden gelöscht

3. **Ungültige URLs entfernen** – Nur URLs mit `http://` oder `https://` bleiben

4. **Sendernamen bereinigen** – Überflüssige Leerzeichen und Sonderzeichen werden entfernt

5. **Leere Gruppen entfernen** – Gruppen ohne Streams werden gelöscht

### Verwendung

1. Laden Sie eine M3U-Datei

2. Klicken Sie auf **🩹 Doctor bereinigen** in der Seitenleiste

3. Eine Zusammenfassung zeigt an, wie viele Streams entfernt wurden

---

## 🌐 7. Sprachwechsel

Das Tool unterstützt **Deutsch** und **English**:

- Klicken Sie auf **🇩🇪** für Deutsch

- Klicken Sie auf **🇬🇧** für English

- Alle Oberflächen-Texte, Dialoge und Meldungen werden sofort aktualisiert

---

## 📊 8. Statusleiste

Am unteren Rand der Anwendung sehen Sie stets:

- 📄 Name der geladenen Datei

- 📺 Anzahl der Streams

- 📂 Anzahl der Gruppen

- 📋 Anzahl der Duplikate

- ● Autosave-Status

---

## ⌨️ 9. Tipps & Tricks

> **Tipp 1:** Nutzen Sie die Suchfelder, um in großen Playlisten schnell den gewünschten Sender zu finden.

> **Tipp 2:** Mit Rechtsklick auf Streams können Sie mehrere gleichzeitig markieren und in eine andere Gruppe verschieben.

> **Tipp 3:** Der Doctor sollte nach jedem Import einer neuen Playlist ausgeführt werden, um die Liste sauber zu halten.

> **Tipp 4:** Picon-Ordner sollten Bilder im Format `SENDERNAME.png` oder `SENDERNAME.jpg` enthalten (Großbuchstaben, Unterstriche statt Leerzeichen).

> **Tipp 5:** IPTV-URLs im Konverter können direkt markiert und mit `type=` Parameter automatisch angepasst werden.

---

## 🔧 10. Systemanforderungen

- **Betriebssystem:** Windows 10/11

- **P_**VLC-Player muss auf Ihrem System installiert sein

- **Optional:** VLC Media Player (für externe Wiedergabe)