FW3.5 XTGuide Jukebox Edition

XTGuide Jukbox Edition
==============================================

FUNCTIONALITY

What it can do
- show content of Jukebox metadata databases
- create folder structures ready to browse by Title, Year, Rate, Genre, ...
- create virtual samba share visible on PRODIGY GUI
- add custom samba share like PRODIGY ROOT ("/") for easy access to device files (in v0.5)
- delete single movie by title (in v0.5)
- clean Jukebox database (in v0.5)
- remove not existing (no working path) Movies from Jukbox database (in v0.5)

XTGuide will not change or remove your movies or files on PRODIGY shares, drives, usb, ...
It will change the Jukebox database (-J command) but all movies and files are safe. The Jukebox data can be easily rebuilt by starting the scrapper again.

Give me the feedback or ideas what to do next, what functionality to add or change.
Use this tool at your own risk - I did my best to make it safe. The sources are open.

I'm working for this tool for fun with python script development with PRODIGY.
It should to work fine with SIDEWINDER3 with FW3.5 too but I have not one to check.


Limitation with v0.4
XTGuide shares remains in PRODIGY internal filesystem but the GUI share is removed on restart.
So for now it is required to mount it manually after restart - v0.5 will do it for you.

I know it is a huge limitation.
But next version (XTGuide, not FW) will fix this so XTGuide will be ready to use just like regular Jukebox.
v0.4 is some kind of preview version just to let me know what do you thint about it .

What doesn't work (yet)?
- no autostart XTGuide mount (to GUI menu) after PRODIGY restart (I'm waiting for AUTOSTART in FW but I will provide workaround soon)
- no way to create XTGuide from PRODIGY GUI - for now it requires telnet/ssh access
- there is a problem with disappearing movies data from Jukebox, can't help but already created XTGuide will have all data

How it works ?
- XTGuide parses Jukebox SQLite databases
- creates symbolic links structure ready to browse by Title, Year, Genre, ...
- creates the share in Xtreamer GUI (Net->WORKGROUP->PRODIGY->XTGuide)

Requirements
- PRODIGY/SIDEWINDER3(not tested by me) with Firmware 3.5 RC2+
- Python 2.7 (easy to install by App Installer)
- Telnet/SSH (or App Installer Console)


INSTALLATION

How install XTGuide ?
1. Install and run App Installer .Net
2. Install Libraries and Python (in Developer Tools Category, or using Search)
3. Install XTGuide (in Others Category)
4. Configure local or netowork shares using Shortcurs
5. Browse you shares and add some content to Jukebox using "6" key and "Get movie info" menu
6. Run the Jukebox to make sure it works fine (XTGuide uses Jukebox database)
5. In App Installer run Console and

/data/epkg/share/xtguide/xtguide.py -h

The output should to be similar to

/data/epkg # /data/epkg/share/xtguide/xtguide.py -h
Usage: xtguide.py [options] arg1 arg2

XTGuide Jukebox Edition v0.4.1 by lemar123 at forum.xtreamer.net
===============================================================================
Functions (see options for extra info):
- parse Xtreamer movie Jukebox metadada (sqlite database)
- lists Jukebox metadata movie database info (details in logfile)
- prepare folder structure (symlinks) to browse by genre, year, title, ...
- shows extra network share in Xtreamer in Net / Workgroup / <DEVICE> / XTguide
- logfile with debug option
- requires Xtreamer Prodigy / Sidewinder3, firmware 3.5+, python 2.7+

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -d, --debug           turn on logfile DEBUG mode, default INFO mode
  -l LOGFILE, --logfile=LOGFILE
                        set full path to logfile
                        default /data/epkg/share/xtguide/xtguide.log
  -p PACKAGE, --package=PACKAGE
                        use PACKAGE as XTGuide home folder
                        default /data/epkg/share/xtguide
  -C, --create          ACTION: creates XTGuide symlink structures
  -I, --install         ACTION: installs XTGuide in Xtreamer menu
  -L, --list            ACTION: lists scrapped movies from databases
                        /tmp/jukebox/f?/movie.db
  -R, --remove          ACTION: removes XTGuide structures (sources are safe)
/data/epkg #

6. Mount XTGuide as PRODIGY share

/data/epkg # /data/epkg/share/xtguide/xtguide.py -I
17:55:00 INF XTGuide Jukebox Edition v0.4.1, by lemar123 at forum.xtreamer.net
===============================================================================
17:55:00 ACT Installing XTGuide in Xtreamer GUI
17:55:00 INF   go to Net->WORKGROUP->PRODIGY->XTguide
===============================================================================
Done
/data/epkg #

This will install XTGuide in Network shares menu.


USAGE

As Jukebox alternative

There are to steps
- prepare XTGuide structure - once after Jukebox scrapping when you add ne files
- mount in PRODOGY GUI - after restart (till v0.5)

Step 1 - Preparing XTGuide
In App Installer console:

/data/epkg # /data/epkg/share/xtguide/xtguide.py -RC
17:51:16 INF XTGuide Jukebox Edition v0.4.1, by lemar123 at forum.xtreamer.net
===============================================================================
17:51:16 ACT Cleaning symlinks in "/data/epkg/share/xtguide/data"
17:51:17 INF   folder "/data/epkg/share/xtguide/data" cleaned
17:51:17 ACT Loading Jukebox movie databases ...
17:51:17 STG Database "/tmp/jukebox/f7/movie.db"
17:51:17 WRN   empty database, no movies loaded !
17:51:17 STG Database "/tmp/jukebox/f5/movie.db"
17:51:17 WRN   empty database, no movies loaded !
17:51:17 STG Database "/tmp/jukebox/f4/movie.db"
17:51:17 INF   2 jukebox movie(s) loaded
17:51:17 STG Database "/tmp/jukebox/f3/movie.db"
17:51:17 WRN   file not exists or isn't a regular file
17:51:17 INF   4 jukebox movie(s) loaded
17:51:17 STG Database "/tmp/jukebox/f2/movie.db"
17:51:17 WRN   empty database, no movies loaded !
17:51:17 ACT Preparing data ...
17:51:17 INF   24 host folder(s)
17:51:17 ACT Creating XTGuide structures ...
17:51:18 WRN source "/tmp/jukebox/f3/mp/1/50 First Dates" nor exists, no symlink creation
17:51:18 INF   host folders and symlinks created
17:51:18 ACT Installing XTGuide in Xtreamer GUI
17:51:18 INF   go to .Net->WORKGROUP->PRODIGY->XTguide
===============================================================================
Done
/data/epkg #

And browse Network shares mentioned above from Xtreamer GUI on TV.
Tbe best idea it to add XTGuide to favourites.

Step 2 - Preparing XTGuide

/data/epkg # /data/epkg/share/xtguide/xtguide.py -I
17:55:00 INF XTGuide Jukebox Edition v0.4.1, by lemar123 at forum.xtreamer.net
===============================================================================
17:55:00 ACT Installing XTGuide in Xtreamer GUI
17:55:00 INF   go to Net->WORKGROUP->PRODIGY->XTguide
===============================================================================
Done
/data/epkg #

This will install XTGuide in Network shares menu.


As Jukebox database utility

Listing Jukebox SQLite database content

/data/epkg # /data/epkg/share/xtguide/xtguide.py -L
17:49:53 INF XTGuide Jukebox Edition v0.4.1, by lemar123 at forum.xtreamer.net
===============================================================================
17:49:53 ACT Loading Jukebox movie databases ...
17:49:53 STG Database "/tmp/jukebox/f7/movie.db"
17:49:53 WRN   empty database, no movies loaded !
17:49:53 STG Database "/tmp/jukebox/f5/movie.db"
17:49:53 WRN   empty database, no movies loaded !
17:49:53 STG Database "/tmp/jukebox/f4/movie.db"
             - New Moon - (nedivx-newmoon.avi)
             - Nights in Rodanthe - (Nights In Rodanthe.avi)
17:49:53 INF   2 jukebox movie(s) loaded
17:49:53 STG Database "/tmp/jukebox/f3/movie.db"
             - Across the Universe - (s-accrossuniverse.mkv)
17:49:53 WRN   file not exists or isn't a regular file
             - 50 First Dates - (50 First Dates.avi)
             - Atonement - (Atonement[2007].Dvdrip.Xvid.AC3[5.1]-BlueRoCKRG.avi)
             - Bad Lieutenant - (Bad Lieutenant.avi)
17:49:54 INF   4 jukebox movie(s) loaded
17:49:54 STG Database "/tmp/jukebox/f2/movie.db"
17:49:54 WRN   empty database, no movies loaded !
===============================================================================
Done
/data/epkg #

If the files are missing from share but remains in SQLite database - you will get warning (as above).


*****************************************

http://forum.xtreame...on-main-thread/


lemar123