maloep/romcollectionbrowser

Kodi - Rom Collection Browser

Rom Collection Browser - XBMC Game Frontend

Current stable version (Kodi Krypton & Leia): 2.2.4

Matrix compatible: Matrix branch

Current development version (Matrix only): Current Git version

Documentation: https://github.com/maloep/romcollectionbrowser/wiki

Kodi Forum thread: http://forum.kodi.tv/showthread.php?tid=70115

XBMCNerds thread (german forum): http://www.kodinerds.net/index.php/Thread/11578-Rom-Collection-Browser-XBMC-Spiele-Frontend/

Features

Game Import / Scraping

• scan your rom folders and import games to local database
  
• scrape artwork and game info from various online sources
  
• import local available data (descriptions, artwork, videos)
  
• results from all different scrape processes can be mixed together
  
• two scraping modes: Automatic: Accurate, Interactive: Select Matches
  
• create local nfo files while scraping (option to reimport local files without scraping)
  
• create scrape result files (missing artwork, missing descriptions, possible mismatches)
  
• import options dialog: asks for most important import options on every game import

Game Browsing

• filter games by console, genre, year, publisher and first character
  
• automatic video playback in video window
  
• game details page
  
• different views of the main window
  
• configurable image placing (choose filetype for background, gamelist, etc.)
  
• fully skinnable UI: already skinned for Estuary, Confluence, Night and Carmichael (other skins will use the Estuary look and feel)
  
• dedicated MAME views to display cabinets and marquees

Game Launching

• launch roms and standalone games in solo or non-solo mode (solo mode quits XBMC and relaunches it when you quit the emulator)
  
• supports direct launching of savestate files
  
• detect games in zip and 7z archives and ask user which game to load
  
• store game launch count in db
  
• restore viewstate when returning to RCB

RCB scrapes data from these sites (don't forget to visit, register and contribute!):

• http://thegamesdb.net - game data + artwork (boxfront, boxback, fanart)
  
• http://www.giantbomb.com - game data + artwork (screenshot)
  
• http://www.mobygames.com - game data + artwork (screenshot, boxfront, boxback, cartridge)
  

RCB also imports game information from some file formats that you need to download first. See the wiki for more information.

Screenshots

Check out the Screenshot gallery

Donate

romcollectionbrowser's Issues

RSS Feeds

The addition of RSS Feeds to be displayed in skin. If possible have them 
separate from the Main Menu RSS feed, so that retro game specific feeds can be 
read from within RCB.

Original issue reported on code.google.com by [email protected] on 11 Jun 2010 at 7:23

edit games

edit all game properties in details page

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:59

filter control interaction

If you select a console remove all genres that are not covered by this console, 
etc.

Original issue reported on code.google.com by maloep on 20 Jun 2010 at 7:40

provide all game properties and images for skinning

next version should provide better skinning support. it should be possible
to add new skins and layouts without any code changes.

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:50

manual and faq browser

import and browse game manuals and faqs (text and image)

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:03

Might be considered a defect - handling of CRCs

When handling a CRC value with a leading zero, that zero is truncated. For 
instance, "0F870806" becomes "F870806".

This is not necessarily a defect, but it is common to refer to the full 8 
character CRC, and thus this results in mismatches. 

It might be worth searching for both strings (i.e. the search you're doing 
already and one padded out with zeros) 

Original issue reported on code.google.com by [email protected] on 16 Jul 2010 at 10:49

game map browser

import and browse maps

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:03

add support for xml description files

Should be possible with xpath support.

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:53

Sometimes no gaminfo is shown at startup

Not sure what happens but sometimes there is just a list with blank details on 
startup. Most times it works.

Original issue reported on code.google.com by maloep on 1 Aug 2010 at 9:17

add dynamic filters

not only console, genre, year and publisher. should be possible to add
every game property as a filter

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:55

Search games per Textbox

Add a textbox and let the User type in a part of the name. Combine this text 
with the filter controls.

Support WildCards like *Mario*.

Original issue reported on code.google.com by maloep on 20 Jun 2010 at 7:34

Launch xbox games freezes xbmc

Works fine with debug on, freezes without debug

Original issue reported on code.google.com by maloep on 19 May 2010 at 7:02

use favorites

option to mark a game as favorite (manually or automatically with a high
launch count)

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:02

Background Music from the Emus

The option to select background music in RCB. Either from using the 
BG Music.mp3 located in the emu skins folder. Or perhaps user imported track 
list.

Original issue reported on code.google.com by [email protected] on 11 Jun 2010 at 7:44

• Merged into: #20

Add support for xbox

- Launch games via RunXBE command
- Create temprary .cut-files to launch a game with parameters (optionally)
- Add a configuration option if game needs to be started with absolute path
or relative path

Original issue reported on code.google.com by maloep on 11 May 2010 at 5:06

add context menu

add a context menu (instead of buttons?) - maybe skin specific?

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:05

unicode characters in synopsis file cause crash

What steps will reproduce the problem?
1. Update database with an entry that has certain unicode characters

For instance, in a file with "René van den Enden" as the developer of a game, 
RCB crashed with the following error:

Error:
10:04:50 T:140305833707792 M:3107155968  NOTICE: self.log("resolved path from 
developer name: " +pathnameFromDeveloper, util.LOG_LEVEL_INFO)
10:04:50 T:140305833707792 M:3107155968  NOTICE:   File 
"/home/mediapc/.xbmc/scripts/Rom Collection Browser 
V0.5/resources/lib/dbupdate.py", lin
e 574, in log
10:04:50 T:140305833707792 M:3107155968  NOTICE: self.logFile.write(prefix + 
message+"\n")           
10:04:50 T:140305833707792 M:3107155968  NOTICE: UnicodeEncodeError
10:04:50 T:140305833707792 M:3107155968  NOTICE: :
10:04:50 T:140305833707792 M:3107155968  NOTICE: 'ascii' codec can't encode 
character u'\xe9' in position 87: ordinal not in range(128)
10:04:50 T:140305833707792 M:3107155968   ERROR: Scriptresult: Error
10:04:50 T:140305833707792 M:3107147776   ERROR: ClearBlock: Trying to clear 
non existent block /home/mediapc/.xbmc/scripts/Rom Collection Brows
er V0.5

In addition to "é", I have encountered this error with "²" (superscript). 

It appears that the crash is only related to error logging?

What version of the product are you using? On what operating system?
RCB 0.5, 64 bit linux

Please provide any additional information below.

Text of problematic synopsis (courtesy of Wimpy's database):

*
245D3533
Pong
Platform: Magnavox Odyssey²
Region: Homebrew
Media: Cartridge
Controller: Odyssey² Joystick
Genre: Sports - Tennis
Release Year: 2004
Developer: René van den Enden
Publisher: Packrat Video Games
Players: 2 VS
_________________________
*
It's a wonder that Magnavox never released pong for the Odyssey 2 back in the 
day. Rene van den Enden has done an excellent job with this game of speed and 
skill. Play solo or against an opponent in this blast from the past! There are 
11 variations of Pong, from Squash to Tennis, to the original classic and more. 
Keep the ball in play as long as possible for the winning high-score or best 
time! Significant to this release is that this cartridge version is 
significantly better than previous releases. The game is now 4K and offers many 
more Pong games and variations. 

Original issue reported on code.google.com by [email protected] on 18 Jul 2010 at 12:14

avoid image flickering while browsing game list

maybe it will be better to load all game infos when the list is created,
not when a game is selected. Have to check performance impact.

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:52

more precise % progressbar on import games

have to check performance impact

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:07

0 Games displayed after Screensaver [Xbox]

What steps will reproduce the problem?
1. Whilst in RCB, let the Screensaver start
2. Press Any key to stop the Screensaver.
3. When RCB reappears there are no games displayed, and you have to exit and 
re-enter for them to be displayed again.

What is the expected output? What do you see instead?
I would expect it to display the games as it did before the screensaver started

What version of the product are you using? On what operating system?
Xbox rev 29407

Please provide any additional information below.
http://pastebin.com/f02LKTUD

Original issue reported on code.google.com by [email protected] on 15 Jun 2010 at 8:27

Short delay before applying filter selection

Make it possible to browse the filters without loading the gamelist on every 
click. Just wait a second and then start loading the list.

Original issue reported on code.google.com by maloep on 20 Jun 2010 at 7:37

Dharma compatibility - prepare branch to add 0.6.x via SVN

maybe have to test this with my own repo first.

Original issue reported on code.google.com by maloep on 1 Aug 2010 at 9:30

video plays always fullscreen on xbox

Try XBMC.PlayMedia instead of Player().play() ?

XBMC.PlayMedia($INFO[ListItem.Trailer]).........Is fullscreen
XBMC.PlayMedia($INFO[ListItem.Trailer],1)...........Is windowed

Original issue reported on code.google.com by maloep on 19 May 2010 at 7:03

Add support for XBMC Live (toggle Fullscreen before launching game)

Add option to minimize XBMC when launching a game in non-solo mode and
maximize it again when it comes back. Check if XBMC is fullscreen before
toggling state.

This seems to be used to launch games in XBMC Live.

Original issue reported on code.google.com by maloep on 11 May 2010 at 5:04

loop videos

XBMC clears the game list when a video stops playing. This requires to
reload the complete list and is annoying with larger collections.

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:48

handle import of multiple rom paths

if there is an error in romPath and you import it again you will end up
with two rom pathes (one corrupted and one correct)

Original issue reported on code.google.com by maloep on 18 May 2010 at 5:52

add file mode (no import to database)

should be possible to ease up usage in simple scenarios (1 image per game,
no description files or only 1 fixed nfo format)

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:16

settings page

not only config.xml as configuration

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:59

support pgup, pgdn, home, end buttons in game list

load game info when using these keys

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:45

better video support

option to toggle from minimized window to fullscreen and back

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:04

Report SynopsisError to Xtras Team for future Xtras releases

A way to send game issues (wrong genre(s), missing artwork, wrong artwork,
wrong synopsis data, data for other missing values etc) to the
RessurectionXtras project members.

Not sure exactly how this should be done, but I can provide a service to
handle data posted to a php script online to add to our database of game
issues.

This would (if used) help us better the synopsis file where it needs fixing.

Example scenario:
 * I open up RCB, browse to SMS and Phantasy Star and see that the Genre is
set to Sports, Baseball. Pressing a key or menu would bring up a textbox
and a "Send Issue" / "Cancel" where I can write "This should be ____ Genre!".

The team over at Xtras will then correct the issue and provide the changes
in the next synopsis release/export*.

This is considered a low priority.

Original issue reported on code.google.com by [email protected] on 9 May 2010 at 5:52

better image scaling

actually all images are stretched to a fixed size. maybe this can be
optimized with checking original with?

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:12

No need to import settings

Read settings directly from xml file without importing

Original issue reported on code.google.com by maloep on 23 May 2010 at 3:42

create separate log files for missing games / artwork

check during import and create single files

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:08

add language support

use language files

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:00

don't restart video when reentering the list

When pressing left to scroll down on description then right again to
reenter the list. the movie restarts.

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:13

Add nfo support

Define nfo file format. Import description automatically if there is a
%GAME%.nfo file in the same directory.

Original issue reported on code.google.com by maloep on 23 May 2010 at 3:56

add support for standalone games

maybe standalone as console / romcollection?

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:06

support music files per game

choose to play music instead of video

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:11

Fix constraint on column name in table game

column name has an unique constarint on name. It is needed on name and
romcollectionId

Original issue reported on code.google.com by maloep on 23 May 2010 at 3:39

Tidy up config examples and default config

provide examples for simple scenarios (1 screenshot, no description)

Original issue reported on code.google.com by maloep on 23 May 2010 at 3:38

delete games

should be possible from ui but also with scanning rom folders for missing games

Original issue reported on code.google.com by maloep on 8 May 2010 at 5:58

Dharma compatibility - get 0.5.1 working on linux

seems to be a problem with loading pysqlite modules atm

Original issue reported on code.google.com by maloep on 1 Aug 2010 at 9:27

error while quick scrolling the game list

video is started in full screen sometimes

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:14

Add loglevel as config option

or use xbmc's loglevel

Original issue reported on code.google.com by maloep on 23 May 2010 at 3:43

no game title in pm3 skin on xbox

only highlighted game shows the title.

have to test this on a pc. maybe a problem on xbox only?

Original issue reported on code.google.com by maloep on 19 May 2010 at 7:05

Here's a couple of possible RCB thumbs ...

Best I can do. No artistic talent here either!

Original issue reported on code.google.com by [email protected] on 31 Jul 2010 at 3:41

Attachments:

• vC.png
• vB.png

stop movie playback when a game starts

only happens when used in solo mode

Original issue reported on code.google.com by maloep on 8 May 2010 at 6:10

Bad performance on xbox using large rom collections

Several problems with large collections on xbox:
- long loading times
- slow reaction while changing filter settings
- always getting a caching error when trying to restart RCB a second time (have 
to reboot xbox before it is working again)

possible solutions:
- limit database size (one db per system)
- more caching options: finding the best way between caching items and loading 
content

Original issue reported on code.google.com by maloep on 1 Aug 2010 at 9:25

Sometimes no gameinfo is shown after closing fullscreen video or game details page

Not sure what happens but sometimes there is just a list with blank details 
after closing fullscreen video or game details page. Maybe related to previous 
issue (same error on startup).

Original issue reported on code.google.com by maloep on 1 Aug 2010 at 9:19