📺 TV Garden Plugin for Enigma2

Professional IPTV Streaming Solution for Enigma2 receivers with access to 50,000+ channels from 150+ countries across 29 categories, plus live webcams from around the world. Featuring smart caching, hardware acceleration, and native Enigma2 bouquet export.

📺 Screenshots

✨ Key Features

🚀 Performance Optimization

Hardware Acceleration - Configurable toggle for H.264/H.265 streams
Buffer Size Control - 512KB to 8MB configurable buffer
Smart Player Selection - Auto, ExtePlayer3, or GStreamer
Memory Optimization - Efficient RAM usage (~50MB)

🌍 Global Content Access

150+ Countries with national flags display
29 TV Categories (News, Sports, Movies, Music, Kids, etc.)
50,000+ Channels regularly updated
Live Webcams - browse by country or by category

📹 Webcams Support

Webcams by Country - browse public live webcams from around the world
Webcams by Category - filter by type (beach, city, nature, mountain, traffic, etc.)
Dynamic Categories - categories are read live from the data source
YouTube & HLS playback - via ytdlpwrapper / streamlinkwrapper

⚙️ Advanced Technology

Smart Configuration System - 20+ configurable parameters
Smart Caching - Enable/Disable, Configurable Size, Force Refresh options
Auto-Skin Detection - HD/FHD/WQHD resolution support
File Logging System - Configurable log level and file output

🔄 Integration & Export

Dual Bouquet Export System - Single-file simplicity or multi-file hierarchical structure
Smart Channel Splitting - Configurable max channels per sub-bouquet file (default 500)
Hierarchical Bouquet Architecture - Parent container with country-specific sub-bouquets
Configurable Export - Bouquet name prefix, max channels per bouquet, export confirmation
Favorites Management - Add/Remove channels, view info, and export directly
Complete Bouquet Management - Tag-based removal of all bouquet files (.tvgarden_*)

🛡️ Reliability & Safety

DRM/Crash Protection - Filtered problematic streams (DASH, Widevine, etc.)
Offline Cache - Browse cached channels without internet
Automatic Updates - Check for plugin updates with backup/restore

🔍 Enhanced User Experience

Channel Zapping - CH+/CH- navigation between channels in player
Real-time Search - Virtual keyboard with case-insensitive search across TV + webcams
Performance Stats - HW acceleration and buffer info in player overlay
Multi-language Interface - Support for international users

📊 Technical Specifications

Component	Specification
Total Channels	50,000+
Countries	150+
TV Categories	29
Webcams	Available by country & category
Configuration Parameters	20+
Player Engines	Auto / ExtePlayer3 / GStreamer
Buffer Size Range	512KB - 8MB
Cache Size	Configurable (10-5000 items)
Memory Usage	~50MB
Load Time (cached)	<5 seconds
Stream Compatibility	~70% success rate
Python Compatibility	2.7+ (Enigma2 optimized)

📦 Requirements

Before installing, make sure the following packages are present:

opkg update
opkg install python3-yt-dlp python3-youtube-dl
opkg install streamlink
opkg install exteplayer3 gstplayer
opkg install ffmpeg
opkg install enigma2-plugin-systemplugins-serviceapp
opkg install enigma2-plugin-extensions-streamlinkwrapper
opkg install enigma2-plugin-extensions-ytdlpwrapper
opkg install enigma2-plugin-extensions-ytdlwrapper

⚙️ ServiceApp configuration

Open:

Menu → Settings → System → ServiceApp

Set Player IPTV to exteplayer3 (recommended) or gstplayer.

⚙️ Configuration System

Player Settings

player = auto               # auto / exteplayer3 / gstplayer

Performance Settings

use_hardware_acceleration = true  # Enable HW acceleration
buffer_size = 2048                # Buffer size in KB (512-8192)
memory_optimization = true        # Memory optimization

Display Settings

show_flags = true          # Show country flags
show_logos = false         # Show channel logos (configurable)

Cache Settings

cache_enabled = true       # Enable caching
cache_size = 500          # Maximum cache items (10-5000)
refresh_method = clear_cache  # clear_cache or force_refresh
force_refresh_browsing = false # Force fresh data when browsing
force_refresh_export = false   # Force fresh data for exports

Export Settings

export_enabled = true     # Enable bouquet export
bouquet_name_prefix = TVGarden  # Bouquet name prefix
max_channels_for_bouquet = 100  # Max channels per bouquet (0=all)
max_channels_for_sub_bouquet = 500 # Max channels per sub-bouquet
list_position = bottom    # top or bottom in Enigma2 list

Browser Settings

max_channels = 500        # Max channels per country (0=all)
default_view = countries  # countries / categories / favorites
sort_by = name            # Sort channels by name / country / category

Network Settings

user_agent = TVGarden-Enigma2/1.0  # Custom user agent
connection_timeout = 30   # Network connection timeout (10-300s)

Logging Settings

log_level = INFO          # DEBUG / INFO / WARNING / ERROR / CRITICAL
log_to_file = true        # Enable file logging

Search Settings

search_max_results = 500  # Max results in search (0=all)

🎮 Usage Guide

Main Menu

Browse by Country      - TV channels by country
Browse by Category     - TV channels by category
Webcams by Country     - Live webcams by country
Webcams by Category    - Live webcams by category
Favorites              - Your saved channels
Search                 - Search across TV + webcams
Settings               - Plugin configuration
Check for Updates      - Check for plugin updates
About                  - Plugin information

Navigation Controls

Browser Controls:

OK / GREEN      - Play selected channel
EXIT / RED      - Back / Exit
YELLOW          - Add/remove favorite
BLUE            - Export current view to bouquet
MENU            - Channel context menu

Player Controls:

CHANNEL +/-     - Zap between channels
OK              - Show channel info + performance stats
EXIT            - Close player

Performance Tips

Buffer Size: 2MB-4MB for stable connections
HW Acceleration: ON for H.264/H.265 streams
Max Channels per Country: 250-500 for faster loading
Cache: Enable for normal use, disable for testing fresh data

Bouquet Export Workflow

Single-File Export: Best for small lists (<1000 channels)
Multi-File (Hierarchical): Recommended for complete database export
- Creates userbouquet.tvgarden_complete_container.tv (parent)
- Creates subbouquet.tvgarden_[country].tv for each country
- Countries with >500 channels are split into parts (e.g., _part1)
Location: /etc/enigma2/*.tvgarden_*
Restart: Enigma2 to see new bouquets

📥 Installation

# Download and install via script (Recommended)
wget -q --no-check-certificate "https://raw.githubusercontent.com/OwnerPlugins/TVGarden/main/installer.sh" -O - | /bin/sh

# Restart Enigma2
reboot

📁 Data Source

Channel and webcam data comes from an external public dataset:

➡ https://github.com/OwnerPlugins/famelack-data

Sources are organized as:

tv/raw/countries/{code}.json       → TV channels by country
tv/raw/categories/{id}.json        → TV channels by category
webcams/raw/countries/{code}.json  → Webcams by country
webcams/raw/categories/{id}.json   → Webcams by category

Categories are read dynamically from the GitHub API — no hardcoded lists.

🔧 Technical Architecture

File Structure

TVGarden/
├── __init__.py
├── plugin.py
├── helpers.py
├── browser/
├── player/
├── utils/
├── skins/
├── icons/
├── locale/
├── installer.sh
└── README.md

Cache System Features

Configurable Enable/Disable: Toggle entire cache system
Force Refresh Options: Fresh data for browsing or export operations
Memory + Disk Cache: Dual-layer for performance
Smart Management: Configurable size limits

Player Features

Hardware Acceleration: Automatic detection for H.264/H.265 streams
Buffer Management: Configurable buffer size applied to service reference
YouTube & HLS: Native support via system wrappers
Performance Settings: Integrated into player initialization

🔍 Search System

Features

Real-time Case-Insensitive Search - Instant results as you type
TV + Webcams - unified search across both sources
Virtual Keyboard - Full text input support
Configurable Limits - 0-1000 results (default: 500)
Cache-aware - Uses cached data when available

⭐ Favorites & Export System

Features

Unlimited Favorites Storage
Smart Deduplication - Prevents adding duplicate channels
Hierarchical Export - Single or multi-file bouquet creation
Complete Management - Add, remove, info, and export options
Bouquet Removal - Clean removal of all .tvgarden_* files

Storage Format

[
  {
    "id": "unique_hash",
    "name": "Channel Name",
    "stream_url": "stream_url",
    "country": "Country Code",
    "added": 1734567890
  }
]

🐛 Troubleshooting

Common Issues

Issue	Solution
Channels not loading	Check internet, clear cache, restart plugin
Player won't start	Verify GStreamer/ExtePlayer3 installation, check URL format
Search not working	Clear cache, check network connection to GitHub
Bouquets not appearing	Restart Enigma2 after export
High memory usage	Reduce cache size, limit max channels per country

Cache Management

Clear Cache: Via Settings screen → "Clear Log Files Now"
Force Fresh Data: Enable "Force Refresh on Browsing/Export" in Cache Settings
Location: /tmp/tvgarden_cache/

Logs & Debugging

View Logs: Settings → View Log File
Log Level: Adjust in Settings (DEBUG for troubleshooting)
Location: /tmp/tvgarden_cache/tvgarden.log

📄 License

TV Garden Plugin for Enigma2
Copyright (C) 2025 TV Garden Development Team

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program 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. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.

🙏 Credits & Acknowledgments

Core Development

Original Concept: Lululla (TV Garden Project)
Upstream Fork: Belfagor2005
Data Source: https://github.com/OwnerPlugins/famelack-data
Fork & Webcams Support: OwnerPlugins

Special Thanks

Enigma2 community for testing & feedback
All contributors and translators

📞 Support & Resources

Fork: https://github.com/OwnerPlugins/TVGarden
Data Source: https://github.com/OwnerPlugins/famelack-data

Enjoy optimized streaming with TV Garden! 📺⚡

Last Updated: 2026 | Version: 2.7

Name		Name	Last commit message	Last commit date
.github		.github
CONTROL		CONTROL
screen		screen
usr/lib/enigma2/python/Plugins/Extensions/TVGarden		usr/lib/enigma2/python/Plugins/Extensions/TVGarden
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
Structure.txt		Structure.txt
enigma2-plugin-extensions-tvgarden.bb		enigma2-plugin-extensions-tvgarden.bb
installer.sh		installer.sh
update_all_plugins.py		update_all_plugins.py

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

📺 TV Garden Plugin for Enigma2

📺 Screenshots

✨ Key Features

🚀 Performance Optimization

🌍 Global Content Access

📹 Webcams Support

⚙️ Advanced Technology

🔄 Integration & Export

🛡️ Reliability & Safety

🔍 Enhanced User Experience

📊 Technical Specifications

📦 Requirements

⚙️ ServiceApp configuration

⚙️ Configuration System

Player Settings

Performance Settings

Display Settings

Cache Settings

Export Settings

Browser Settings

Network Settings

Logging Settings

Search Settings

🎮 Usage Guide

Main Menu

Navigation Controls

Performance Tips

Bouquet Export Workflow

📥 Installation

📁 Data Source

🔧 Technical Architecture

File Structure

Cache System Features

Player Features

🔍 Search System

Features

⭐ Favorites & Export System

Features

Storage Format

🐛 Troubleshooting

Common Issues

Cache Management

Logs & Debugging

📄 License

🙏 Credits & Acknowledgments

Core Development

Special Thanks

📞 Support & Resources

About

Resources

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages