Jump to content
LaunchBox Community Forums

Add To Games DB AddToGamesDb v.Next

   (3 reviews)

3 Screenshots

About This File

*** 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.


What's New in Version AddToGamesDb v.Next   See changelog

Released

AddToGamesDb v.Next:

  • Adding initial support for LaunchBox v.Next.  This only works with Chrome.  Please let me know if you encounter any issues.

AddToGamesDb 2.5.0 Update:

  • Support for LaunchBox 8.0+.
  • Confirmation dialog after successful game submission.
  • General bugfixes to support the latest releases.

AddToGamesDb 2.4.0 Update:

  • Fixed issue causing LaunchBox to crash.
  • Updated to latest drivers for browser automation.

AddToGamesDb 2.3.0 Update:

  • Updated for .NET Framework 4.7 being used in the latest beta of LaunchBox.
  • Updated automation.
  • Updated error checking to skip any Image Types that are not yet implemented in the form.
  • An issue was identified with custom platform names, so for now, when it is time for the automation to enter the platform name, if you have set a custom platform name, the automation will pause while you manually select the platform, then resume after you click "Add Game".

AddToGamesDb 2.2.0 Update:

  • Made the Chrome version portable!  You will need to enter your username and password on the login form and select Remember Me again, but now your Chrome profile for the automation will be stored in a Profile folder within the plugin's folder.  No more AppData for it.
  • Also, Chromedriver.exe was updated from 2.2.9 to 2.3.0 this week, and the latest version is included here.  A changelog for the latest version can be found here.
  • Maintenance changes -- stability, flexibility and re-usability improvements in the code.  Now that I've finally gotten around to it, please note that if you're also using Startup Video Manager, you will likely need to update it as well.  They share a DLL or two and that will ensure both are running optimally.  Now that everything's in order, it shouldn't be an issue going forward, but since this is the first time I've moved the code around in this way, both plugins may need to be updated to the current release to guarantee full functionality.

AddToGamesDb 2.1.0 Update:

  • Found a race condition that could be encountered when adding images to an existing game that already has other images on it.  This update solves for this possibility.

AddToGamesDb 2.0.0 Update:

  • Supports the latest versions of the LaunchBox Games Database submission pages.
  • Relaxed automation code where possible to be more resilient to page changes.
  • Added pop-up dialogs if an error is encountered that caused submission to fail so that the user gets some feedback on any issues.
  • Re-write of all automation code with extensive error handling and logging.
  • Improved support for various metadata fields.
  • Tweaked automation timeout settings to allow for a reasonable amount of time for slower internet connections, without causing too much lag for faster connections.
  • Activated configurable NLog logging to capture everything needed for any debugging issues that may arise from form submission page changes.

AddToGamesDb 1.5.0 Update:

  • Fixed an edge case where the automation will pause for an extended period when populating existing games that do not have any images associated with them.

AddToGamesDb 1.4.0 Update:

  • Re-wrote the implementation that checks for existing games being updated.  This functionality is working now.

AddToGamesDb 1.3.1 Update:

  • Solved for a race condition when choosing to update an existing game that could cause the automation to stop.

AddToGamesDb 1.3.0 Update:

  • Added support for multiple Developers, Publishers and Genres.
  • Added support for Max Players and Cooperative fields.

AddToGamesDb 1.2.0 Update:

  • Increased timeout for image uploads to ensure that all image uploads have time to complete.
  • Added support for all remaining Image Types -- thanks @Jason Carr!

AddToGamesDb 1.1.0 Update:

  • Support added for Screenshot - Gameplay image type.
  • Added initial logging support.
  • Cleaned up underlying code -- better stability, reduced total file size, getting everything ready for more testing and logging capability.
  • Changed the way Metadata.xml (LocalDB) is being loaded to see whether or not a game already exists in the database.
  • Like 23
  • Unusual Gem 2

User Feedback

Recommended Comments



At the moment, those aren't supported through the Plugin API, but I'll definitely keep adding support for the additional fields as soon as they become available.

Link to comment
Share on other sites

Hi @flores9!  I'll be working on it this afternoon, so I'll be sure to go in and test that out to make sure it's working for the next update.  Thanks for the heads up!

Link to comment
Share on other sites

One more update tonight:  Added support for multiple publishers, developers and genres, as well as support for the Max Players and Cooperative fields!

  • Like 2
Link to comment
Share on other sites

@UnderwoodNC I´m just update to last beta and works the other images types!!. Great!

Another case I don´t know if is implemented. I have a game that already exists in the DB, but I have more images (in this case are ingame and title screens), I click in the game update option, it prompt me to the DB and find the game that exists in the DB. I click the game and open the add images tab, but nothing more happens...  I don´t know if this is a issue or not is implemented.

 

Thanks!

  • Like 1
Link to comment
Share on other sites

Ok, perfect, I just tried the same case but with boxes images, and the result it´s the same. The "plugin" freezes when arrived to the game that already exists and don´t add any image.

Link to comment
Share on other sites

@UnderwoodNC I just tried. I don´t get that extras images been upload.

I try to specific the steps:

- Select a game that already exists in the GameDB, especifically "Aliens: the computer game" for Amstrad CPC.

- The game only have metadata, no images in the DB

- I have downloaded the box front, screen gameplay and title

- I select the option of your plugin for update game in the DB

- IT prompt me to the LBDB and ask me if it´s a game that already exists

- I select the existing game on the DB

- The script stop on the metadata screen of the game and nothing happens

- If I pass the mouse over the images links (even if I don´t click on the link) it goes to the images tab, but it freezes here

- I need to close manually the explorer and in sometimes the focus doesn´t come back to LB and I need to force the close of LB

 

Sin título.png

Sin título_2.png

Link to comment
Share on other sites

@flores9 Thanks for the steps, that will help with debugging.  Is it working with other games?  Is the issue only with existing games that do not already have any images?

Unfortunately, I need to head to bed for now, but I'll definitely look into this tomorrow to see if I can wrap up this issue for you.

Link to comment
Share on other sites

@UnderwoodNC this issue only happens when a game already exists in the DB and I try to add a new artwork. I tested with a few differents games, and the results are the same.

Link to comment
Share on other sites

@flores9, @polocatfan Hi all, I've re-written the part of the code that checks for whether or not it's an existing game, and in my tests it is working consistently.  Please download the latest version and let me know if you run into any issues.

Link to comment
Share on other sites

@UnderwoodNC sorry, I try another game, Alien 8 for Amstrad CPC, with a similar situation. But in this case it upload a screen gameplay, but not title gameplay.

Can affect the name of the game??, for example the box for the game "Aliens: The Computer Game" is "Aliens_ The Computer Game-01.jpg"

Link to comment
Share on other sites

I´m trying the Altered Beast game, and it´s the same result of Alien 8, only missed the title screen, so its probably that the plugin can´t be upload this image type?

And the case of Aliens: ....  could be for the difference between the name of the game and the images (":" --> "_"), this is a conversion that LB does.

 

Link to comment
Share on other sites

I've updated games with colons ":" and other special characters, so I don't think that's it.  The different image file name should be okay as long as it's being picked up by LaunchBox.  A few questions to try to help me pinpoint the issue:

- Are you using Firefox or Chrome?

- Are the Screenshot - Title Screen images showing up when you go to Edit the game in LaunchBox?

- It's working on the other games now (except for title image), but still does not work for Aliens: The Computer Game?

Link to comment
Share on other sites

Chrome.

All the images im tryinh to upload can be viewed in the edit window of the game.

In other games it works, only fails the title image. But I want to say that now only tested 5 or 6 games.

 

Link to comment
Share on other sites

Right-o, I've added it to LB to test and found an issue for existing games without any images, and it's fixed in the release I just uploaded.  Thanks for your patience @flores9 in figuring out what was going on, taking care of issues like this helps to make this an even better plugin for everybody, and it's much appreciated.

  • Like 1
Link to comment
Share on other sites

@UnderwoodNC yes!yes!yes!. It works now both cases, with front boxes and screen titles!!!

I only noticed that back boxes (in the cases I mentioned previously) don´t upload. I trying today to do more testing. Thanks!.

Link to comment
Share on other sites

I just put threw a heap of submissions with your tool, using firefox it seems to stop when it trys to click the add image link, i have to manually do it myself and then it runs the rest out as intended

Link to comment
Share on other sites

with Chrome it will not work well. It starts fast but than It will always have my LogIn datas. So I started it with Firefox, but this is really slow to add Images or a Game to it. Sure better than making everything manually over the page but having build up a so felt completely new System (Sega ST-V) and 59 Games, it still takes hour. Maybe it depend on the performance behavior of LB itself.

there looks like a issue. when I right click a game, I only have the option to upload a new image to the database. Pressing it goes to the screen and I have to submit a new game into the Database... and I have to press submit on the page. 

still great work

Edited by Chris Kant
Link to comment
Share on other sites

Thanks @massatomic I haven't had a chance to do a lot of testing with Firefox yet.

@Chris Kant If it's showing as Add New Images, but the game doesn't have a LaunchBox Games ID, then it found that game in the latest version of the database that was downloaded.  If that's the case, please try to have LaunchBox find the game again, it should be there.  I'll check add image button issue this afternoon.  Are you also on Firefox?  I'm not sure what you mean by it will always have your login data for Chrome?

Link to comment
Share on other sites


Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Unfortunately, your content contains terms that we do not allow. Please edit your content to remove the highlighted words below.
Add a comment...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...