# CiefpVideoPlayer v1.2
## CiefpVideoPlayer ##
is an advanced video player for Enigma2 devices with support for:
-
Local playback (HDD, USB, CF cards)
-
Network shares (SMB/CIFS, NFS)
-
Online streaming (M3U and Enigma2 .tv playlists)
-
TMDB integration for movie and series info
-
Poster and metadata caching
-
Configurable cache settings, API keys and languages
## Supported formats: MP4, MKV
(via built-in Enigma2 player)
## Requirements:
Python 3.x, Enigma2 based image (OpenATV, OpenPLi, PurE2, etc.)
Skin 1920x1080 (FHD)
Quick start guide
## Navigation (FHD skin 1920x1080)
Button Function
- ◀ ▲ ▼ ▶ ........Navigation through files/folders
- OK ..............Open folder / play video
- Red (RED)....Exit plugin
- Green (GREEN)....Local files (HDD/USB)
- Yellow (YELLOW)....Network content (SMB/NFS)
- Blue (BLUE)....Online content (GitHub M3U/TV lists)
- MENU ............Main menu (TMDB info, settings, cache)
## Local playback
Press GREEN → select location (HDD, USB, USB2, Root)
Navigate to video file → press OK
## Network content (SMB/NFS)
Press YELLOW → select option:
Connect to Laptop – manually enter IP address and share name
Browse Network Shares – view already mounted shares
Add Network Share – add SMB or NFS share
Auto-Scan – scan network for SMB devices
## Online content (M3U / .tv lists)
Press BLUE → select:
GitHub TV Lists – download Enigma2 .tv lists from GitHub
GitHub M3U lists – download M3U lists from GitHub
Manual URL – manually enter M3U or direct stream link
## TMDB info (Movie/TV Show info)
Select video file (local or from online list)
Press MENU → select Movie Info (TMDB) or TV Show Info (TMDB)
The plugin automatically parses the file name and searches TMDB
## Settings
Press MENU → Settings
TMDB API Key Setup – enter TMDB API key (required for info)
OMDb API Key Setup – enter OMDb API key (optional, for IMDb ratings)
Cache Settings – set cache size, clear cache
Language – select language (English, Serbian Latin/Cyrillic)
## Caching
Posters and metadata are cached in /tmp/ciefp_cache
Recommended cache size: 100-200 MB
The Auto-clear on exit option automatically clears the cache on exit
config.json file (structure)
Create a file at the path:
text
/usr/lib/enigma2/python/Plugins/Extensions/CiefpVideoPlayer/config.json
{
"tmdb_api_key": "YOUR_TMDB_API_KEY_HERE",
"omdb_api_key": "YOUR_OMDB_API_KEY_HERE",
"cache_size_mb": 100,
"auto_clear_cache": false,
"cache_dir": "/tmp/ciefp_cache",
"show_imdb_rating": true
}
Field Explanation:
Field Type Description
tmdb_api_key.......string.....Required – TMDB API Key (obtain at themoviedb.org)
omdb_api_key.......string.....Optional – OMDb API key (for IMDb ratings)
cache_size_mb......integer....Maximum cache size in MB (default: 100)
auto_clear_cache...boolean....Clear cache automatically on exit (true/false)
cache_dir..........string.....Path to cache folder
show_imdb_rating...boolean....Show IMDb rating in TMDB info screen
Known issues and solutions
Problem Solution
TMDB info not working.............Check API key in settings
Network share not mounted....Check if cifs-utils is installed
GitHub lists not loading..Check internet connection
Slow folder loading......Reduce cache_size_mb or increase timeout
Plugin structure
text
CiefpVideoPlayer/
├── plugin.py # Main plugin file
├── CiefpSettings.py # Settings
├── TMDBInfoScreen.py # TMDB info screen
├── background.png # Background image (placeholder)
├── icon.png # Plugin icon menu
└── config.json # Configuration file (created automatically or manually)
Usage note
TMDB API key is required for info screen functionality.
You can get it for free by registering at themoviedb.org.
OMDb API key is optional – used only for IMDb ratings.
You can get it for free omdbapi.com
..:: CiefpSettings ::..
## CiefpVideoPlayer ##
is an advanced video player for Enigma2 devices with support for:
-
-
-
-
-
-
## Supported formats: MP4, MKV
(via built-in Enigma2 player)
## Requirements:
Python 3.x, Enigma2 based image (OpenATV, OpenPLi, PurE2, etc.)
Skin 1920x1080 (FHD)
## Navigation (FHD skin 1920x1080)
Button Function
- ◀ ▲ ▼ ▶ ........Navigation through files/folders
- OK ..............Open folder / play video
- Red (RED)....Exit plugin
- Green (GREEN)....Local files (HDD/USB)
- Yellow (YELLOW)....Network content (SMB/NFS)
- Blue (BLUE)....Online content (GitHub M3U/TV lists)
- MENU ............Main menu (TMDB info, settings, cache)
## Local playback
Press GREEN → select location (HDD, USB, USB2, Root)
Navigate to video file → press OK
## Network content (SMB/NFS)
Press YELLOW → select option:
Connect to Laptop – manually enter IP address and share name
Browse Network Shares – view already mounted shares
Add Network Share – add SMB or NFS share
Auto-Scan – scan network for SMB devices
## Online content (M3U / .tv lists)
Press BLUE → select:
GitHub TV Lists – download Enigma2 .tv lists from GitHub
GitHub M3U lists – download M3U lists from GitHub
Manual URL – manually enter M3U or direct stream link
## TMDB info (Movie/TV Show info)
Select video file (local or from online list)
Press MENU → select Movie Info (TMDB) or TV Show Info (TMDB)
The plugin automatically parses the file name and searches TMDB
## Settings
Press MENU → Settings
TMDB API Key Setup – enter TMDB API key (required for info)
OMDb API Key Setup – enter OMDb API key (optional, for IMDb ratings)
Cache Settings – set cache size, clear cache
Language – select language (English, Serbian Latin/Cyrillic)
## Caching
Posters and metadata are cached in /tmp/ciefp_cache
Recommended cache size: 100-200 MB
The Auto-clear on exit option automatically clears the cache on exit
Create a file at the path:
text
/usr/lib/enigma2/python/Plugins/Extensions/CiefpVideoPlayer/config.json
{
"tmdb_api_key": "YOUR_TMDB_API_KEY_HERE",
"omdb_api_key": "YOUR_OMDB_API_KEY_HERE",
"cache_size_mb": 100,
"auto_clear_cache": false,
"cache_dir": "/tmp/ciefp_cache",
"show_imdb_rating": true
}
Field Explanation:
Field Type Description
tmdb_api_key.......string.....Required – TMDB API Key (obtain at themoviedb.org)
omdb_api_key.......string.....Optional – OMDb API key (for IMDb ratings)
cache_size_mb......integer....Maximum cache size in MB (default: 100)
auto_clear_cache...boolean....Clear cache automatically on exit (true/false)
cache_dir..........string.....Path to cache folder
show_imdb_rating...boolean....Show IMDb rating in TMDB info screen
Problem Solution
TMDB info not working.............Check API key in settings
Network share not mounted....Check if cifs-utils is installed
GitHub lists not loading..Check internet connection
Slow folder loading......Reduce cache_size_mb or increase timeout
text
CiefpVideoPlayer/
├── plugin.py # Main plugin file
├── CiefpSettings.py # Settings
├── TMDBInfoScreen.py # TMDB info screen
├── background.png # Background image (placeholder)
├── icon.png # Plugin icon menu
└── config.json # Configuration file (created automatically or manually)
TMDB API key is required for info screen functionality.
You can get it for free by registering at themoviedb.org.
OMDb API key is optional – used only for IMDb ratings.
You can get it for free omdbapi.com
..:: CiefpSettings ::..