Plugin.MusicBox4 History

Show minor edits - Show changes to output

Changed lines 25-26 from:
The latest version of the MusicBox4 plugin is v9.3
to:
The latest version of the MusicBox4 plugin is v10.0.1
Added lines 209-211:
'''10.0'''
'''25-Aug-2015'''
* various fixes
Added lines 210-211:
'''11-July-2012'''
* Remove debug popup, turn off options when folders not found.
Changed line 29 from:
'''Music Box4 - 9.3'''
to:
'''Music Box4 - 9.4'''
Changed line 107 from:
Additionally when no art is found it will look in your Skin folder for generic art for display for the folder Skin\Default\MusicBox4\Backdops
to:
Additionally when no art is found it will look in your Skin folder for generic art for display for the folder Skin\Default\MusicBox4\Backdrops
Added lines 100-115:
!!!FanArt and Backdrops

MusicBox4 is automatically configured to download and display music artist backdrops from the great collection at htbackdrops.com in the Jukebox view.  The art is stored in the NextPVR Data Folder Media\Artists and you will need to create this folder.  The config settings for this in MusicBox.xml are

      <DownloadFanart>true</DownloadFanart>
      <ArtistFanart>true</ArtistFanart>

Additionally when no art is found it will look in your Skin folder for generic art for display for the folder Skin\Default\MusicBox4\Backdops

This is the setting for it.

      <DefaultFanart>true</DefaultFanart>

Some nice generic is available here

http://www.htbackdrops.com/v2/thumbnails.php?album=9
Added lines 193-195:
'''9.4'''
'''10-July-2012'''
* Music Fanart (backdrop) support display and automatic downloads
Added lines 193-196:
'''9.3'''
'''14-December-2011'''
*Improved mouse support
*Navigate in music
Changed lines 1-2 from:
(:description  A database based music and jukebox player for NPVR :)
to:
(:description  A database based music and jukebox player for NextPVR :)
Changed lines 5-6 from:
Music Box 4 is a plugin that does not use a directory structure for holding music files.  It is based on [[~psycik]]'s MusicLibrary 2 and 3 updated and refreshed for NPVR.
to:
Music Box 4 is a plugin that does not use a directory structure for holding music files.  It is based on [[http://forums.gbpvr.com/member.php?5002-psycik|psycik's]] MusicLibrary 2 and 3 plugin, updated and refreshed for NextPVR.
Changed line 53 from:
Configuration is done through standard NPVR Config by right clicking on the NPVR screen
to:
Configuration is done through standard NextPVR Config by right clicking on the NextPVR screen
Changed lines 3-7 from:
(:comment PLEASE SET THE FILENAMES EXPLICITLY BY REPLACING THE {$Name} AT 3 PLACES BELOW:)

(:comment ATTACH A SMALL SCREENSHOT OF YOUR PLUGIN:)
Attach:{$Name}Main.jpg

to:
(:thumb MusicBox4Main.jpg width=690 :)
Changed line 18 from:
Attach:MB4Playlist3.jpg
to:
(:thumb MB4Playlist3.jpg width=690 :)
Changed line 20 from:
Attach:MB4Playlist.jpg
to:
(:thumb :MB4Playlist.jpg width=690 :)
Changed lines 22-23 from:
Attach:MB4Playlist2.jpg
to:
(:thumb MB4Playlist2.jpg width=690 :)
Deleted lines 38-39:

Changed line 41 from:
This plugin has been tested with NPVR v2.1.4 and above - it requires .Net 2 framework installed. 
to:
This plugin has been tested with NextPVR v2.1.4 and above - it requires the .NET 2.0 framework to be installed. 
Changed lines 200-203 from:
to:
'''22-July-2011'''
*Improved handling of files with no album tag
*Multiple issues resolved with single folders containing several files
*Added @controlSelected for active column
July 02, 2011, at 10:26 PM by mvallevand - 2.1.4 Updates
Added line 14:
*Album Art Downloading
Changed lines 28-29 from:
The latest version of the MusicBox4 plugin is v9.1.4 BETA
to:
The latest version of the MusicBox4 plugin is v9.2.1 BETA
Changed line 32 from:
'''Music Box4 - 9.1'''
to:
'''Music Box4 - 9.2'''
Changed lines 46-49 from:
This plugin has been tested with NPVR v2.0.3 and above - it requires .Net 2 framework installed.  Version 2.03 also requires patches for NPVR

[[http://forums.gbpvr.com/showthread.php?49919-Plugin-Additions-and-notes&p=410372#post410372]]

to:
This plugin has been tested with NPVR v2.1.4 and above - it requires .Net 2 framework installed. 
Added lines 198-204:

'''9.2 Beta'''

'''02-July-2011'''
*Album art downloading
*FSW updates
*Pause changes for 2.1.4
May 29, 2011, at 02:19 PM by mvallevand -
Changed lines 200-206 from:
'''26-May-2011 - 9.1 Beta'''
to:
'''9.1 Beta'''

'''29-May-2011'''
*Album view on menu
*Delay screen write option
*Update UltraID3Lib
'''26-May-2011
'''
Changed lines 208-209 from:

'''23-May-2011 - 9.1 Beta'''
to:
'''23-May-2011'''
Changed lines 47-48 from:
It uses the following external id3 tag libraries.[[http://forums.gbpvr.com/showthread.php?49919-Plugin-Additions-and-notes&p=410372#post410372]]
to:
[[http://forums.gbpvr.com/showthread.php?49919-Plugin-Additions-and-notes&p=410372#post410372]]

It uses the following external id3 tag libraries.

Changed line 55 from:
Both of these libraries are placed in the NPVR Program\plugins\common directory.
to:
For your convenience these libraries are preinstalled, Taglib-sharp in the NPVR Program directory and UltraID3Lib in the NPVR Program\plugins\common directory.
May 27, 2011, at 03:04 AM by mvallevand -
Added lines 198-200:
'''26-May-2011 - 9.1 Beta'''
*Added new Album Artist View options

Deleted line 202:
Changed lines 33-34 from:
Download:MusicBox4.7z
to:
Download:MusicBox4.7z  (DownloadCount:MusicBox4.7z downloads)
Changed line 70 from:
*'''Sort By Track''' - sets the default sort to track, off, sorts alphabetically - in GBPVR change from Home Menu
to:
*'''Sort By Track''' - sets the default sort to track, off, sorts alphabetically - in NPVR change from Home Menu
May 23, 2011, at 09:36 PM by mvallevand -
Deleted line 27:
Attach:MusicBox4.7z
May 23, 2011, at 02:03 PM by mvallevand -
Changed line 23 from:
no download yet Downl0ad:MusicBox4.7z
to:
Attach:MusicBox4.7z
May 23, 2011, at 01:44 PM by mvallevand -
Changed lines 1-3 from:
((:comment PLEASE SET THE FILENAMES EXPLICITLY BY REPLACING THE {$Name} AT 3 PLACES BELOW:)
to:
(:description  A database based music and jukebox player for NPVR :)

(:comment PLEASE SET THE FILENAMES EXPLICITLY BY REPLACING THE {$Name} AT 3 PLACES BELOW:)
May 23, 2011, at 01:23 PM by mvallevand - Music Box 4 Plugin
Added lines 1-197:
((:comment PLEASE SET THE FILENAMES EXPLICITLY BY REPLACING THE {$Name} AT 3 PLACES BELOW:)

(:comment ATTACH A SMALL SCREENSHOT OF YOUR PLUGIN:)
Attach:{$Name}Main.jpg

Music Box 4 is a plugin that does not use a directory structure for holding music files.  It is based on [[~psycik]]'s MusicLibrary 2 and 3 updated and refreshed for NPVR.

*It supports basic ID3v1 and ID3v2 tag reading.
*Multiple Directories/Drives for media
*Playlists - M3U importing now supported
*Album Art (including embedded)
*Music Collections
*Jukebox mode
*CUE file support
*Audioscrobbling/Last.FM updating (TBD)

Attach:MB4Playlist.jpg Attach:MB4Playlist2.jpg Attach:MB4Playlist3.jpg

!!Downloading and Installing
The latest version of the MusicLibrary3 plugin is v9.1.4 BETA
no download yet Downl0ad:MusicBox4.7z

Uncompress and run the installer.  Contains skin files for Default only.


'''Music Box4 - 9.1'''
Download:MusicBox4.7z

!!Explanation of Components
Here is what the different DLLs do:

Tag-lib-sharp.dll is an external tag reader
ultraid3lilb.dll is an external (MP3 only) tag reader.
Interop.wmp.dll - this is the Windows Media player DLL.



!!Requirements

This plugin has been tested with NPVR v2.0.3 and above - it requires .Net 2 framework installed.  Version 2.03 also requires patches for NPVR

It uses the following external id3 tag libraries.[[http://forums.gbpvr.com/showthread.php?49919-Plugin-Additions-and-notes&p=410372#post410372]]

UltraID3Lib - this is a very good, MP3 only tag reader.  It supports album art within mp3 files and can be downloaded from http://home.fuse.net/honnert/hundred/

Tablib-sharp - this library handles almost anything you can throw at it, and also handles embedded album art.  Available from http://www.taglib-sharp.com/Main_Page.

Both of these libraries are placed in the NPVR Program\plugins\common directory.

!! Configuration

Configuration is done through standard NPVR Config by right clicking on the NPVR screen

!!!General
*'''Database settings''' - set the type and location of your MusicBox4 database file
*'''Always Query''' - on by default means every key press re-queries the database.  To improve performance, turn this off, this will mean navigating the left hand screen will only update unless you press enter, or move off the left hand screen.
*'''Play Button Queues''' - Make the play button queue tracks instead of starting a new playlist.
*'''Delete Dead Files''' will remove missing files from the database that cannot be found during a scan
*'''Insanely Stupid Amount of Logging''' Special logging, makes huge logs files, so only do so on request.
*'''Internal ML2 Logging''' - Creates a separate log file for MusicBox  - kept in NPVR\Logs directory*

!!!View
*'''Remove (All) option''' - remove the (ALL) option from the left panel.  Designed for people with very large collections
*'''Sort By Track''' - sets the default sort to track, off, sorts alphabetically - in GBPVR change from Home Menu
*'''Remove "The"''' remove's "The" or "A" from the start of an artist and puts it at the end, e.g Perfect Circle, The

!!!Playlists/Playing
*'''Default Random Period''' - how many mintues of music to play when the random playlist button or menu option is hit.
*'''Jukebox Mode Wait Time''' - ''tkgafs'' - once MB4 has been started and opened, if it is just left, after this period of time, in seconds, a random playlists will be started - 0 to turn off.
*'''At the End of a Random Playlist''' - start a new random playlist or just stop.
*'''M3U Playing Indicator''' - adds "(M3U)" to the end of an imported playlist.
*'''Remote Text Entry''' - use remote text entry rather that the OnScreen keyboard for saving playlist names.*
*'''Random Always ALL/ALL''' - when in random ML2 will normally take what is currently shown in the title screen as it's selection of tracks to create a random play list from.  This option just forces ML2 to always select all tracks before creating a playlist
*'''While Playing Show''' set the default viewing. Also sets whether playback position is shown.*
*'''Export/Import Playlists''' Exports play lists held in the DB to files, can be used before/after an upgrade*

!!!Media Library/Collections
*'''Set the paths and collections''' - set paths and collections details below.

!!!Library Update
*'''Fast Scan Interval''' - the number of hours between fast scans - only updated those files that have changed - added/deleted or renamed, since the last scan O to disable.
*'''Skip File Name''' - customizable file name for skipping a directory from the main database - this used to be hard coded as noindex.txt
*'''Skip file Recursive''' - whether to skip all files in a directory structure rather that just the individual directory.


!!!Last.FM
*Last.FM/Audioscrobbler settings for uploading current listened to tracks to the Last.FM social website This has never been tested looking for volunteers.

!!!Album Art
Album Art is read from a file folder.jpg or default.jpg, cover.jpg in the directory containing the MP3 file.  UltraID3 lib is included this will attempt to read embedded album art.

In order album art is read:
Embedded in track
Song name.jpg
Album name.jpg
Folder.jpg
Default.jpg.


!!!Configuring Paths
In the config app under '''Media Library/Collections'''

Specify the directories where media is housed.  When starting for the first time a default path of C:\ is included. This can be deleted.  It will be attached to a collection called system.  See below for an explanation of collections.

Paths are stored in the MusicBox4 database.

These are collections of music, say Xmas, Kids etc.
*First set up the all paths that will be used in the system - these will all appear under the system heading
**eg: C:\Music\Xmas, C:\Music\Kids, C:\Music\EverythingElse
*The Click on Collections, then click new collection - name the collection in the pop up box, and choose the paths for that collection
**eg Xmas - choose the C:\Music\Xmas path
*Click ok. - You should now have "System" at the top with 3 paths in it, and under "collections" there should be "Xmas" with one path.
*To set a collection is default (rather than system), right click on the collection name and set as default.

Confused yet??  Try it and see.

Now you can scan everything, if you've made changed to the collections they will need to be saved for the scan to work.



!!Using the Plugin

!!!Library Screen
*Press the right and left buttons to navigate between the Artists, Albums and titles.
*Pressing "Play" on the Artists will play all songs by the selected artist
*Pressing "Play" on the Album will play all songs from that album
*Pressing "Play" on each title will play that song

*Pressing the OK/Enter will shuffle the selected songs instead of creating a new playlist. On the tracklisting it will give several options to Play or Queue

*A random playlist can be generated by pressing the Red Button (Alt-R).  The amount of time the playlist will try to fill is selected in the config app (Default Random Period)

*There is a context sensitive menu accessible with the Menu button - home key to change views, options and select Random play without a button on the remote.

*The Options sub menu contains options for changing the sort order of tracks, switching between collections and genre updating the library* and a few other options.

* The Green key (Alt-G) switches MusicBox4 from an Artist/Album/Title configuration to Compilation/Artist/Title and Genre/Artist/Title

* Ctrl-K (record on hauppauge remotes) removes an entry from a playlist

*You can use your remote control key pad to "type" letters, these will make the cursor jump to the first artist, album or genre starting with those letters.  With the Hauupauge 45 Key remote "Prev Channel" button (CTRL-W) to erase a character, the '*' to shift between Caps lock on or off - has no effect while searching, space is the '0' key.  Press ok to accept that entry and clear or move to the right.

*Pressing the Yellow (Alt-Y) button will show the playlists screen. 


!!!Playlist Screen
*If playing, the playlist screen will show tracks currently playing. 

*The last played Playlists is saved for replay

Press the Ctrl-K key (record) to delete a playlist.  M3U playlists will come back in the next scan. -  [B]- NOT YET IMPLEMENTED[/B]

Pressing the record key on a track will delete the track from the playlist, if playing, it will restart the current play after deletion.

If a track has been identified as having an associated cue file by showing "(CUE)" on the title, this track can be "opened" by hitting enter (ok) on it, this will show all of the sub tracks - and as the track plays it will update with the currently playing.  '''NOTE:''' hitting next or previous track will skip to the next track in the playlist, not the next track in that cue file!! [B]- NOT YET IMPLEMENTED[/B]


!!!CUE Files
I listen to a Trance radio show every week from Holland. These are 2 hour long sets, and what some people do is add a cue sheet for these large mp3s.  I've implemented CUE files as a way of showing the contents of a large, radio show mp3 file. It just means it shows what track you're up to.

Originally Cue files were used for ISO files.  Or using tools like mp3Direct cut, it will take a cue file and split the mp3 tracks up into individuals  for storing on a an audio cd.



!!Support
This plugin is discussed in the [[http://forums.gbpvr.com/forumdisplay.php?f=19 | Recording2, MusicLibrary2, SystemStatus Support forum]]

!!Source Code
(:comment IF YOU WOULD LIKE TO MAKE THE SOURCE CODE AVAILABLE; ADD IT HERE:)


!!Known Limitations
*I sure there are some more.

!!Donations

If you feel like you would like to donate to Psycik for the original MusicLibrary 2 or 3.  [[http://gbpvr.com/pmwiki/pmwiki.php/Plugin/MusicLibrary3]]

!!Todo
*Create an album table
*Better support for boxed sets multiple disk CD's
*Multiple artists? - add option to take '&' 'and' '/' 'feat' and treat as sep artists, exclude certain ones (Simon and Garfunkel"
*Change remote text entry to be a screen (ala winamp), search everything, not just the one field.


!!Author(s)
[[~mvallevand]]
[[~psycik]] (:comment CHANGE THE NAME; IT IS AUTOMATICALLY LINKED TO A PROFILE:)
[[jaggy]]

!!History

'''23-May-2011 - 9.1 Beta'''
*Completed the re-write from ML3 to MB4 - Thanks to Jaggy and ACTCMS for lots of alpha testing and valuable comments


Category:[[!Music]] [[!Plugin]]

Page last modified on October 06, 2015, at 01:58 AM