VLCStream - A media player for the G19.


Install:
Get VLC 1.1.11 from: http://www.videolan.org/


Unpack the Vlcstream archive in to the VLC install location.
(vlcstream.exe and vlc.exe should be in the same directory.)


Executing:
Run vlcstream.exe, or through the commandline pass the media file to vlcstream.exe
Eg; vlcstream "f:\path\to\file.ext"
Eg; vlcstream "f:\path\to\a playlist.m3u8" 12

Use < and > to set VLC specific per track options.
Eg; vlcstream "dvb-t://frequency=538000000 <bandwidth=8,no-spu>"
Eg; vlcstream "f:\path\to\videofile.ext <video-filter=rotate,rotate-angle=45>"


Controls:
To enable mouse control: Shift+Control+A or Q or Enter, or run 'vlcsEnableCursor.exe'
Middle Mouse button to end.
Right mouse button to center cursor.
Mouse control can also be ended by clicking the cursor icon situated top left of the playback screen.

Play selected track (red highlight): Control + Play
Stop playback: Control + Stop
Select previous track: Control + Prev
Jump to next track: Control + Next
Adjust volume up/down: Control + Volume keys
Take a Screenshot: Control + Alt + S
(about keys are configurable from within vsskin/data/config.cfg)

VLCStream also provides an internal command prompt for advanced playback control and playlist manipulation.
To enable command prompt: Control+Shift+L or P.
Escape to close prompt and return keyboard control back to Windows.

All commands must be preceded by a '#' (hash)
All other requests without the hash (#) are assumed to be search queries.
Eg; '#volume 85' to set the volume to 85%. A track must be playing to take effect.
Eg; 'hands clean (' will search through all track paths and meta details (if available) for the string 'hands clean ('

Command format: #cmd argu1 argu2 etc..

Command list:
nn                                 - go to playlist or track nn
list                               - print available commands

(playlist manager)
plm                                - go to playlist manager (album page)
plm #n                             - select and go to playlist #n
plm new <name>                	   - create a new playlist
plm delete #n                      - remove playlist n
plm merge #s #d nodup              - merge playlist #s to the end of #d, deleting #s. add nodup (optional) to prevent duplicating tracks
plm copy #s #d nodup               - add playlist #s in to #d. add nodup (optional) to prevent duplicating tracks
plm move #from #to                 - move playlist at position #from to position #to
plm swap #a #b                     - swap playlist positions
plm prune                          - remove any item which points to an invalid path, from every playlist
plm first                          - select first playlist
plm last                           - select last playlist
plm next                           - select and go to next playlist (scroll down by one)
plm prev                           - select and go to previous playlist (scroll up by one)
plm dump                           - debug use only. dump playlist names to console
plm save <name>                    - save all playlists to playlist <name>. 'name' should not contain the file extension (ie; .m3u8)
                                     load again with '#pl ld #0 name.m3u8'

(playlist/pl)
pl                                 - open active playlist page
playlist up                        - scroll up playlist
playlist down                      - scroll down playlist
playlist prune                     - remove any item which points to an invalid path from within selected playlist
playlist copy #f-t #p              - copy tracks at positions #f-t to playlist #p (f:from, t:to, p:playlist). eg; 'pl cp #9-1 #5'
playlist move #from #to            - move track at position #f to position #t. eg; 'pl mv #8 #1'
playlist del #f-t                  - delete tracks from #f to t
playlist clear                     - remove all tracks from playlist
playlist setname <name>            - rename selected playlist
playlist settitle <title>          - set track title of selected playlist item
playlist setartist <artist>        - set artist of selected playlist item
playlist add <dir/track>           - add track or contents of a directory in to selected playlist
playlist save #n <path to .m3u8>   - save playlist #n to <path> (m3u8 format only (utf8))
playlist load #n <path to .m3u8>   - import .m3u8 playlist <path> in to playlist #n. use #0 to import multilists/recursive/root playlists
playlist remove <mtag> <tag>       - remove tracks from selected playlist matching this tag (eg; '#pl remove artist alanis', '#pl remove path .jpg')
playlist exclude <mtag> <tag>      - as above but creates a playlist with tracks removed
playlist extract <mtag> <tag>      - create a playlist from selected playlist with only those tracks which carry this tag
playlist decompose <mtag>          - separate selected playlist in to multiple playlists by tag (eg; #pl decom album)

find <mtag> <query>                - find a track by its meta information (eg; #find album under rug)

artsize                            - set artwork image size (1-20) in playlist. does not apply to playlist manager page

getmeta                            - try to preload all track meta data and artwork of selected playlist
getlengths                         - retrieve all media track lengths'

sorta <mtag>                       - sort selected playlist in ascending order by meta tag (album, artist, path, etc..)
sortd <mtag>                       - as above but in descending order

play                               - play selected track
stop                               - stop playing track
next                               - go to and play next track
pause                              - pause playing track

shelf                              - go to albums page
album                              - go to selected album
selected                           - jump to selected track within album playlist

time h:m:s                         - jump to position in track (hh:mm:ss)
fastforward n                      - skip forward n seconds
rewind n                           - go back n seconds
random                             - on/off. enable/disable random track playback

quit                               - exit program
exit                               - close the input prompt
close                              - close all pages and return to main

display restart                    - attempt to reconnect to LCD
display virtual open               - enable the virtual LCD
display virtual close              - disable the virtual LCD (unwise if the LCD hasn't been connected)

meta                               - open track meta properties page
clock                              - show the clock
config                             - go to config page
stream                             - display general codec and any available ES information 
dvb                                - if available, go to DVB EPG
subtitle                           - if available, open subtitle config

title n                            - go to video track n when playing multi track video (eg; VOB)
chapter n                          - go to chapter n of playing title (eg; VOB, MKV, etc..)
chapter next                       - select next chapter
chapter previous                   - select previous chapter
nc                                 - select next chapter
pc                                 - select previous chapter

about                              - print general application information
backlight <n>                      - set USBD480 backlight intensity (1-255)
snapshot <filename>                - save screenshot (.PNG)
skin reload                        - reload skin images from disk

fps on                             - switch on fps display
fps off                            - switch off
fps nn                             - set display update rate to nn (1-100). this does not effect the video/movie fps

mouse on                           - switch on mouse control (oe use left control+left shift+a or q)
mouse off                          - switch off mouse control

aspect auto                        - set video aspect ratio to auto detect
aspect <n:n>                       - force pixel aspect ratio to x:y (eg; 16:9)
aspect <n.n>                       - force pixel aspect ratio to x.y (eg; 1.77)

rgbswap on                         - enable video RGB Red/Blue component swap. 
rgbswap off                        - disable above swap

idle on                            - enable idle mode (default). display will go in to a reduced update rate after ~120 seconds of inactivity
idle off                           - disable idle feature

open                               - open file browser
open <dir/track>                   - import directory or track in to selected playlist
load <dir/track>                   - as above

volume n                           - set volume from 0 to 100 (only valid when media is playing)
                                     0 = mute

visual                             - enable audio visualization
visual off                         - disable audio visualization
visual n                           - set which audio visual to use (eg; 3)
                                     0:none but displays available track meta  (default)
                                     1:VU meter
                                     2:Spectrometer
                                     3:Pineapple
                                     4:Spectrum
                                     5:Scope
                                  for Logitech G19
                                     6:Goom 320x240
                                     7:Goom 224x168
                                     8:Goom 160x90



Valid meta tags for the above (case insensitive):
Title, Artist, Genre, Copyright, Album, Track, Description, Rating, Date, Setting, URL,
Language, NowPlaying, Publisher, EncodedBy, artPath, TrackID, Length, Filename, Playlist, Path


---------------


Note regarding the artwork:
libVLC will attempt to automatically download track artwork. Once saved locally, artwork is then made available to VlcStream.
The speed at which VLC acquires the track image artwork depends on several factors, but mostly related to your internet bandwidth
and availability of search provider.
Once VlcStream has acquired the image location (UTF8 - MRL), it is then be recorded in the playlist for later retrieval.
On exit, VlcStream will save the current playlist to 'vlcsplaylist.m3u8' which is then automatically imported at startup.


Feedback and suggestions welcomed.
---------------------------------

Michael McElligott
web: http://mylcd.sourceforge.net

Contact:
Email: okio@users.sourceforge.net
Forum: okio @ http://www.logitechusers.com/forumdisplay.php?f=16
http://mylcd.sourceforge.net/vlc/index.html
---------------------------------





