Jump to content
LaunchBox Community Forums

2 Screenshots

About This File

This plugin adds a command line interface to LaunchBox/BigBox for launching games via Stream Deck or having platform and playlist shortcuts. Marquee(s)* and LEDBlinky get updated automatically. Launching games on a remote PC is also supported.

*All Marquees will be updated when using either LaunchBox or BigBox if you are using the ThirdScreen Plugin. If you're using the default BigBox marquee handling, then your single marquee will be updated when using BigBox only.

 

Installation:

  1. *** Before installing, if you are using the ThirdScreen plugin please make sure you are using the latest version.
  2. Download CLI_Launcher.zip to your PC. Right click on the zip file and extract all files.
  3. Close LaunchBox/BigBox and copy the Plugins and ThirdParty folders to your LaunchBox directory. 

 

Usage (simple game shortcuts):

  • Right click on a game in LaunchBox and choose "CLI Launcher->Create Windows Shortcut".

image.thumb.png.3396e88cf1a020547ba0a8f083e5f8cd.png

  • A dialogue will open to allow you to choose the name and location of the game shortcut. When ready, click "Save" to create the shortcut.
  • To create windows shortcuts for a batch of games at once: Select multiple games, right-click and choose "CLI Launcher->Create Windows Shortcuts".

 

Usage (advanced shortcuts and Stream Deck):

The currently supported commands are listed below. These can be run from a Stream Deck, from AHK scripts, or directly from the command line. To run a command from a Stream Deck, open the Stream Deck app and drag the Open action onto one of your buttons. Then on the App/File line, enter the commands as shown below including any required parameters. For example:

image.thumb.png.facc60933e48c115363b53275a5abf96.png

 

Game Shortcuts (launch command)(works with both LaunchBox and BigBox)

     "<path_to_launchbox>\ThirdParty\CLI_Launcher\CLI_Launcher.exe" launch "<platform_name>" "<game_name>"

 

For example, to launch Street Fighter Alpha 2 from the Arcade platform:

"C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" launch "arcade" "Street Fighter Alpha 2"

New in v7.0.0 (launch_by_id command): To launch a game using its game id instead of platform name/game title you can use the launch_by_id command. For example:

"C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" launch_by_id "1e48ac15-55e2-47f7-a33e-486451a16def"

New in v7.0.3 (launch_by_db_id command): To launch a game using its database id instead of platform name/game title you can use the launch_by_db_id command. For example:

"C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" launch_by_db_id "2532"

New in v8.0.1: The option "-t=num_minutes" can be passed to the launch commands. The game will be launched and then automatically closed after the specified number of minutes. By default it will attempt to use the ESC key to exit the game, but for games where that won't work (e.g Windows games) then you can also pass "-altf4" to tell it to use Alt-F4 to exit instead.

 

 

Platform Shortcuts (platform command)(added in v2.0.0 - only works with BigBox)

     "<path_to_launchbox>\ThirdParty\CLI_Launcher\CLI_Launcher.exe" platform "<platform_name>"

 

For example, to navigate to the Arcade platform in BigBox:

"C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" platform "arcade"

New in v8.0.1: The option "-all" can be passed to the platform command instead of a specific platform. This will take you to the platform/playlist root menu.

 

Playlist Shortcuts (playlist command)(added in v2.0.0 - only works with BigBox)

     Run, "<path_to_launchbox>\ThirdParty\CLI_Launcher\CLI_Launcher.exe" playlist "<playlist_name>"

 

For example, to navigate to the favorites playlist in BigBox:

"C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" playlist "favorites"

 

Open Manual for Currently Selected Game (manual command)(added in v8.0.2 - works with BigBox and LaunchBox)

     Run, "<path_to_launchbox>\ThirdParty\CLI_Launcher\CLI_Launcher.exe" manual

 

For example, to open the manual for the currently selected game:

"C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" manual

 

Remote commands:

To run a command on a different PC that has the plugin installed and is running LaunchBox or BigBox just add "remote_ip=<ip_of_remote_pc>". For example, to launch a game on a different PC with IP 192.168.168.238:

"CLI_Launcher.exe" launch "arcade" "Street Fighter Alpha 2"  "remote_ip=192.168.168.238"

 

FAQs:

Q. What if neither LaunchBox nor BigBox are open when the script runs?

  A. The command will get ignored if LaunchBox or BigBox is not open. As of version 8.0.0 you'll also get an error message when trying to run shortcuts without LaunchBox or BigBox being open.

Q. What if a game is already open when the script runs?

  A. The command will just get ignored if a game is already open.

Q. Why not just launch the emulator and/or game directly from the Stream Deck or script?

  A. Using CLI Launcher is much simpler and leverages all the work you've already done in setting up LaunchBox to properly launch the game. Also, if you were to run the emulator and/or game directly from a script, your Marquee(s) and LEDBlinky would not get updated for the game.

Q. Instead of manually entering the command for a Stream Deck button, can I use the "Create Windows Shortcut" game menu item and then just point Stream Deck to that shortcut?

  A. Yes, but... Elgato's Stream Deck app has a quirk where if you use the file selector button to select a shortcut, it will jump straight to the executable that the shortcut points to and it will ignore any parameters that the shortcut was passing in. So to get it to work with a shortcut you have to just type out the full path to the shortcut (including the .lnk extension) on the App/File line instead of using the file selector button.

Q. If I want to use remote commands, which port do I need to ensure is open?

  A. If you are having trouble with remote commands, ensure port 0xb0b0 is open in Windows Firewall on the remote PC. 

Q. Why would anyone want to launch a game on a remote PC?

  A. Dunno... but you can now.

 

 

 

Edited by superrob3000
Updated instructions


What's New in Version 9.0.0   See changelog

Released

Updated to .NET 9.0 to support LaunchBox versions 13.19 and higher.

  • Like 8
  • Thanks 1

User Feedback

Recommended Comments



olvrteil

Posted (edited)

Hello, don't understand how it works. Would you explain a little bit ?

I created a text file with AHK extension, but how do you use it in streamdeck ? if i just do a shortcut, windows ask with what program to open file.

I downloaded autohotkey but when i open file i have an error This line does not contain a recognized action.

Edit : find myself good command line in ahk file :  Run C:\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe launch "arcade" "game name"

Thanks

Edited by olvrteil
superrob3000

Posted (edited)

30 minutes ago, olvrteil said:

Hello, don't understand how it works. Would you explain a little bit ?

I created a text file with AHK extension, but how do you use it in streamdeck ? if i just do a shortcut, windows ask with what program to open file.

I downloaded autohotkey but when i open file i have an error This line does not contain a recognized action.

 

Thanks

Sure, no problem. Let's work through it and then I'll update the instructions to be more clear.

First off, you have to have both AutoHotKey and the Stream Deck App installed, but it sounds like you've done that already.

Then create a one-line text file with extension ahk using the command you want from the instructions (replace anything in brackets with the correct value).

Now close the script file, right click it, and choose "compile script". That should give you an executable file.

Open the Stream Deck app and in the GUI drag the "open" action (the rocket ship icon) onto the button you want to use.

Now on the App/File line, click the "Select a file" button.

Select the executable file that you created above.

At that point you should be able to press the Stream Deck button to run the command.

Edited by superrob3000
shrek6446

Posted

This addin is awesome.. I have been looking for a great way to integrate my Streamdeck and Bigbox together.. 

I am able to get the Platform and Game Shortcuts working great but the Playlist isn't working correctly... Is there anything that I need to differently compared to the example.

I created a playlist in Launchbox called "Pokemon" and created the script based on your example. I also double checked and I see the playlist in Big Box and the path was correct (again the game and platform scripts work great). 

Any Thoughts?  

superrob3000

Posted

15 minutes ago, shrek6446 said:

This addin is awesome.. I have been looking for a great way to integrate my Streamdeck and Bigbox together.. 

I am able to get the Platform and Game Shortcuts working great but the Playlist isn't working correctly... Is there anything that I need to differently compared to the example.

I created a playlist in Launchbox called "Pokemon" and created the script based on your example. I also double checked and I see the playlist in Big Box and the path was correct (again the game and platform scripts work great). 

Any Thoughts?  

@shrek6446 Glad to hear it's working for you. For the playlist shortcut that isn't working, can you provide the following:

1. Please post the log file located at LaunchBox/Logs/StreamDeckGameLauncher.txt

2. What is the full command line you are using?

3. Open LaunchBox. right click on the playlist, choose edit, and send a screen shot of the Edit Playlist window.

shrek6446

Posted

Thank you for the Help

 

1. I attached the streamdecklauncher.txt.. I thought it was Pokemon but it was a Power Rangers Playlist.

 

2. Run, "C:\Users\Shrek\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" playlist "Power Rangers"

3. image.thumb.png.069cd47be2723cbf88e2f8e6b9e64bc4.png

StreamDeckGameLauncher.txt

  • Thanks 1
superrob3000

Posted

@shrek6446 Thanks for pointing this out. I uploaded a new version (v4.0.0) which should fix the issue.

  • Thanks 1
TekkamanBlade

Posted

Thanks! I was going to reach out but this fixed the issue I had where the Playlist command was not working.

  • Like 1
shrek6446

Posted

Thank you for the update! Works great now!

TapeWorm

Posted

Hey bud, first of all thank you for this tool, I really appreciate it.

I'm wondering if it's possible to skip the game menu when launching games?

The reason I ask is because my theme plays a video preview in the individual game menus, and when launching via Streamdeck, it'll open the game menu before starting the game. But the video+sound from the video-preview will play in the background. I have the option to skip the game menu enabled in Big Box, but it seems that launching via the plugin will still show it. I'll look for a way to disable video previews in just the game menu in case this is how things need to work. Wondering if anyone else has come across this issue?

The second oddity I noticed is that if I launch games one after another without exiting the game menus mentioned above, then it's like it's stacking the back-button history in Big Box. As-in, if I launch Duck Hunt and then launch HotD after closing Duck Hunt, then the back button will take me from the HotD's game menu back to Duck Hunt's game menu. I.e. if I launch 5 games, then hitting back will bring me to the previous game's menu. Kind of like clicking back through a web browser's history.

superrob3000

Posted

50 minutes ago, TapeWorm said:

Hey bud, first of all thank you for this tool, I really appreciate it.

I'm wondering if it's possible to skip the game menu when launching games?

The reason I ask is because my theme plays a video preview in the individual game menus, and when launching via Streamdeck, it'll open the game menu before starting the game. But the video+sound from the video-preview will play in the background. I have the option to skip the game menu enabled in Big Box, but it seems that launching via the plugin will still show it. I'll look for a way to disable video previews in just the game menu in case this is how things need to work. Wondering if anyone else has come across this issue?

The second oddity I noticed is that if I launch games one after another without exiting the game menus mentioned above, then it's like it's stacking the back-button history in Big Box. As-in, if I launch Duck Hunt and then launch HotD after closing Duck Hunt, then the back button will take me from the HotD's game menu back to Duck Hunt's game menu. I.e. if I launch 5 games, then hitting back will bring me to the previous game's menu. Kind of like clicking back through a web browser's history.

@TapeWorm Sure, if you want to skip navigating to the game menu before the game is launched then grab the latest version and replace the "launch" command with "launch_without_menu". One thing to keep in mind though, if you have a marquee and are using BigBox's default marquee support, then the marquee will not update correctly when you skip navigating to the game menu. You would have to switch to using the ThirdScreen plugin for the marquee to work correctly with this command.

TapeWorm

Posted

Wow, I really appreciate it. It worked great and the things I mentioned above are no longer issues for me. 🤯

  • Like 1
Vitaly17

Posted

Thank you so much for the 5.0 update and the launch_without_menu commands. Games run without a menu. Ledblinky and third screen plugin work without additional commands. Great job!

  • Like 1
Vitaly17

Posted

Sorry, I was in a hurry. There are problems with Ledblinky. The panel lights up properly but then fades out.

superrob3000

Posted

31 minutes ago, Vitaly17 said:

Sorry, I was in a hurry. There are problems with Ledblinky. The panel lights up properly but then fades out.

Ok, thanks. Does blinky not work consistently if you try the shortcut a few times? I've noticed that in general blinky just sometimes decides not to work when a game is launched. Also, does blinky work when you  use the game shortcut with LaunchBox open instead of BigBox?

Vitaly17

Posted

If you launch the game through launchbox, then ledblinky first tells the management of another game, then the one that starts and everything works fine.
Through the Bigbox, the control of the desired game speaks immediately, but after the buttons go out. I have tested it several times.

superrob3000

Posted

1 hour ago, Vitaly17 said:

If you launch the game through launchbox, then ledblinky first tells the management of another game, then the one that starts and everything works fine.
Through the Bigbox, the control of the desired game speaks immediately, but after the buttons go out. I have tested it several times.

@Vitaly17 Does this one work any better for you?

CLI_LauncherPlugin.dll

Vitaly17

Posted

39 minutes ago, superrob3000 said:

@Vitaly17 Does this one work any better for you?

CLI_LauncherPlugin.dll 17.5 kB · 0 downloads

I tested the modified plugin in the big box.
If you run the game from the main menu, then everything is fine. If you log into some playlist or system and run the script from there, then ledblinky repeats everything twice. Actually, I found a solution. So I use rocket launcher for all my emulators, I set up ledblinky in it and turned it off in launchbox. The only thing I had to create a bat file to start ledblinky and close ledblinky before starting and closing bigbox.

@echo off
start C:\LEDBlinky\LEDBlinky.exe
start /w "" "G:\LaunchBox\Core\BigBox.exe"
START "" C:\Users\Arcade\Desktop\scripts\ledonoff\kill.exe
EXIT

 

madruk20

Posted

Hello! Awesome plugin, I've been using it alot this past week to create a favorites list of common games I play using stream deck buttons.  Is it all possible to use the database game ID's (for instance for Street Fighter 2 Alpha its 2532) to launch games by ID's instead?  I ask since the local ones are all randomly generated so you can't export stream deck profiles with already created buttons if I wanted to share them with someone else.

superrob3000

Posted (edited)

1 hour ago, madruk20 said:

Hello! Awesome plugin, I've been using it alot this past week to create a favorites list of common games I play using stream deck buttons.  Is it all possible to use the database game ID's (for instance for Street Fighter 2 Alpha its 2532) to launch games by ID's instead?  I ask since the local ones are all randomly generated so you can't export stream deck profiles with already created buttons if I wanted to share them with someone else.

@madruk20 no problem, v7.0.3 adds the option to launch a game by its database id. Just keep in mind that this will be the slowest of all the game launching options because the database lookup can take a few seconds.

Edited by superrob3000
  • Thanks 1
superrob3000

Posted

25 minutes ago, superrob3000 said:

@madruk20 no problem, v7.0.3 adds the option to launch a game by its database id. Just keep in mind that this will be the slowest of all the game launching options because the database lookup can take a few seconds.

@madruk20 never mind about the delay. That should be fixed if you grab v7.0.4. Launching by database id should be just as fast now as the other options.

madruk20

Posted

I figured out something you can do with the remote launcher.  Using a local smart speaker on Home Assistant, you can say something like, "Speaker, play Pac Man", and you can have it save it as a string after the word play and use the remote launcher to voice activate games! Pretty cool.

  • Like 1
Fursphere

Posted (edited)

Quote

 

Q. Why would anyone want to launch a game on a remote PC?

  A. Dunno... but you can now

 

Answer - So  you can sync up multi-player games across multiple launchbox installs.  aka - netplay

Thank you so much for this.  I'll be trying it out on my Daytona USA Twin cabinet very soon.

Edited by Fursphere
  • Like 1
Fursphere

Posted

Is it possible to have this plugin navigate to a specific game during attact mode?    Can it be used to basically keep two side by side launchbox / bigbox installations in sync during attract mode?    (for a twin cabinet racing setup in my case)

superrob3000

Posted

9 hours ago, Fursphere said:

Is it possible to have this plugin navigate to a specific game during attact mode?    Can it be used to basically keep two side by side launchbox / bigbox installations in sync during attract mode?    (for a twin cabinet racing setup in my case)

Good idea, but there is currently no way for a plugin to do that (telling BigBox to go to a certain game in attract mode).


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