Add To Games DB AddToGamesDb v.Next

*** Updated for Initial Support for LaunchBox v.Next ***

AddToGamesDb:  A plugin to help automate the process of submitting all of your game information and images from your collection to the LaunchBox Games Database.

About the Plugin

This plugin makes use of an application traditionally used in automated testing (Selenium) to automate the process of submitting games to the LaunchBox Games Database.  It will open an instance of your default browser (provided that browser is either Chrome or Firefox.  If some other browser is your default, it will try to open Chrome), and attempt to submit the selected game to the LaunchBox Games Database based on the information provided in your collection. 

• If the game does not exist in the database, it will create a new game entry and submit it to the database.
• If you have added additional information or images to a game that already exists in the database, it will enter the title and platform, then pause to let you choose the existing game, then add any additional information from your collection to the LaunchBox Games Database.

Installation Instructions

Note:  For this plugin to work, you will need to have either Chrome or Firefox installed.  If you have both installed, it will use whichever you have set as your default browser.  If you are using Firefox as your default browser and have enabled Firefox Profiles, please note that this will run under the default profile.  For any and all other cases, Chrome is the preferred browser.

1. Unzip everything to the Plugins folder.

Usage Instructions

Note: If, in editing your collection, you are prompted to download an update for the LaunchBox Games Database, afterward you will need to close and re-open LaunchBox for the plugin to detect the changes.

1. Open LaunchBox and browse to a game that is either missing from the Games Database, has additional information not in the database, or has images not in the database -- right click that game, and select the appropriate option, it will show either:
   • Add Game to LaunchBox Games Database
   • Update Game in LaunchBox Games Database
   • Add New Images to LaunchBox Games Database
2. The first time you run the plugin, you may be prompted to login to LaunchBox Games Database.  If so, the plugin will pause here to allow you to login as normal. Check "Remember Me" to skip this step going forward.  Your login information is not read or stored in the code, it is stored in Chrome or Firefox's normal AppData cache on your system.  If you do not login, the plugin will time-out after 5 minutes and close the browser. 
3. Depending on the game, you may be prompted with a screen that identifies similar titles and you will be asked to either select the correct title, or click the button to add a new game.  If so, the plugin will pause here until you make your desired selection, then automation will resume for the remainder of the process.

Logging

By default, the logging is only set to a general "Info" level and up that contains generic start and submission successful messages, along with any errors encountered.  If you continue to encounter an error somewhere along the way, please take the following steps:

1. Browse to the plugin's folder -- LaunchBox\Plugins\AddToGamesDb
2. Open NLog.dll.nlog in Notepad or another text editor.
3. Scroll down to the bottom and find the <rules> section of the configuration.
4. Find this line: 

   <logger name="*" minlevel="Info" writeTo="file" />

   And change it to this: 

   <logger name="*" minlevel="Trace" writeTo="file" />

    

5. Try to submit the problem game, if it is a particular game causing the issue, or another game in general otherwise.

6. Browse to the log file in the plugin's folder -- LaunchBox\Plugins\AddToGamesDb\log\AddToGamesDb.log

7. Feel free to post the error and preceding trace either on the plugin's support page or PM me either the entire log or the part pertaining to the last issue, whichever is easier for you.  From there, I'll investigate and make any updates necessary.

Supported Fields

Auto-population of the following fields is currently supported:

• Name/Title
• Platform
• Release Date
• ESRB
• Developers
• Publishers
• Genres
• Wikipedia URL
• Overview
• Max Players
• Cooperative
• Images

Known Issues

• Context Menu (right-click menu) does not refresh on Audit window.
• If you update the information for a game in LaunchBox (clicking Edit from the right-click menu for the game), you will need to click away from the game (click some other game, for example), and then right-click on the updated game again for the context menu to update.  Even without doing so, however, the correct process should run even though the text and icon on the menu haven't yet updated.

A lot of work has gone into stabilizing the initial release and this latest release, but if you encounter any issues, please let me know and I will be glad to work with you to update the plugin accordingly.

Thanks, Jason, for providing your amazing software and thanks again to Jason, the LaunchBox staff and the community for your support in developing this plugin.