superrob3000 Posted December 6, 2023 Share Posted December 6, 2023 CLI Launcher - LaunchBox Command Line Interface for launching games directly from Stream Deck View 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: *** Before installing, if you are using the ThirdScreen plugin please make sure you are using the latest version. Version 3.0.1 or higher is compatible. *** Download CLI_Launcher.zip to your PC. Right click on the zip file and extract all files. 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 "Create Game Shortcut". 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. Usage (advanced shortcuts and Stream Deck): Game Shortcuts (launch command): (works with both LaunchBox and BigBox) Create an AHK script with the following line, and point your StreamDeck shortcut to that script: Run, "<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: Run, "C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" launch "arcade" "Street Fighter Alpha 2" Platform Shortcuts (platform command): (added in v2.0.0 - only works with BigBox) Create an AHK script with the following line, and point your StreamDeck shortcut to that script: Run, "<path_to_launchbox>\ThirdParty\CLI_Launcher\CLI_Launcher.exe" platform "<platform_name>" For example, to navigate to the Arcade platform in BigBox: Run, "C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" platform "arcade" Playlist Shortcuts (playlist command): (added in v2.0.0 - only works with BigBox) Create an AHK script with the following line, and point your StreamDeck shortcut to that script: Run, "<path_to_launchbox>\ThirdParty\CLI_Launcher\CLI_Launcher.exe" playlist "<playlist_name>" For example, to navigate to the favorites playlist in BigBox: Run, "C:\Users\Administrator\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" playlist "favorites" 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: Run, "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 just get ignored if LaunchBox or BigBox is not 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 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 the script, your Marquee(s) and LEDBlinky would not get updated for the game. 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. Q. Are AutoHotKey scripts really necessary? A. No, that's just the way I do it. You could also just point the Stream Deck shortcut directly to CLI_Launcher.exe and pass in the correct arguments. Submitter superrob3000 Submitted 12/05/2023 Category Third-party Apps and Plugins Quote Link to comment Share on other sites More sharing options...
derekpacoAlt Posted December 26, 2023 Share Posted December 26, 2023 Thanks soo much for this plugin, it works perfectly. It took me a little while to get everything set up, so I wanted to share what I've done in case it's helpful for anyone else. First, I needed to install AutoHotkey (I'm not a regular Windows user and this was unfamiliar to me). Found at https://www.autohotkey.com/ This added a shortcut to the right-click popup menu in Windows ... New-->AutoHotkey Script ...this gives a basic script with some default startup commands that I left as-is From there I could use the format indicated by adding a new line to the script using the Run command (i.e., prepend the line with "Run"). .I ran LaunchBox to test. The script works when double-clicked and when launched from Stream Deck via a System-Run macro. I was then going to create scripts for all the games I wanted to launch from Stream Deck. I noticed a couple of things: NotePad happily strips away the file type identifier if you use "Save As", making the script a plain text file, which can't be launched, so be careful with that. When the AHK script is launched a terminal window pops up for a second. This behaviour can be changed by passing the "Hide" option to the AHK Run command (see the attached script) I didn't want to create a separate script file and separate Stream Deck macro for each game. Instead, I use StreamDeck to pass the name of the game as an argument to a generic AHK script (attached, you'll need to update path details to reflect your setup). I had to install the (very nice) Advanced Launcher Stream Deck plugin to do this because the default System launcher in Stream Deck doesn't like arguments. Note 1: all of my go-to games are for the "arcade platform", so I don't pass platform as an argument, but this could be done easily enough: AHK uses numbered variables for each argument, so %1% gets the value of the first argument, %2% gets the second, and so on. Note 2: any game names with spaces or punctuation should be provided in double quotes to be sent to the script as a single argument PlayGame.ahk 1 Quote Link to comment Share on other sites More sharing options...
superrob3000 Posted December 26, 2023 Author Share Posted December 26, 2023 @derekpacoAlt I'm glad it's working for you and thanks for sharing those details. I've updated the instructions with the missing Run command. Also, if you are using the Stream Deck Advanced Launcher and want to remove the AHK step altogether, you could point the Stream Deck shortcut to CLI_Launcher.exe and pass in the correct arguments. 1 Quote Link to comment Share on other sites More sharing options...
DemmyTree Posted June 8 Share Posted June 8 CLI is super but i notice that keep getting a brief command prompt pop up when using the function, i know theres @echo off for bat files, but is there a way this could be silent in the background somehow? Quote Link to comment Share on other sites More sharing options...
superrob3000 Posted June 8 Author Share Posted June 8 20 minutes ago, DemmyTree said: CLI is super but i notice that keep getting a brief command prompt pop up when using the function, i know theres @echo off for bat files, but is there a way this could be silent in the background somehow? Try passing the Hide parameter to the Run commands like @derekpacoAlt mentioned above. I'll update the instructions to include it. Quote Link to comment Share on other sites More sharing options...
DemmyTree Posted June 8 Share Posted June 8 ah i've been using command prompt for using it but it doesnt have a silent mode through that method, using something called MacroDeck as an alternative to Streamdeck, it does support AHK scripts but i'll have to try use that instead Quote Link to comment Share on other sites More sharing options...
banggun Posted August 6 Share Posted August 6 Very cool plugin really great to be able to call on launchbox from outside. However I'm wondering would it be possible to launch your game by using the the location or game ID perhaps. I can understand it may not be everyone's preference but with the current way of launcing you can't launch alternative apps/versions such as megaman 2 vs. rockman 2. Also if you used an ID and or file location it wouldn't be necessary to call on a specific playlist/platform but perhaps that's exactly the reason why it's not possible now ... Quote Link to comment Share on other sites More sharing options...
superrob3000 Posted August 7 Author Share Posted August 7 5 hours ago, banggun said: Very cool plugin really great to be able to call on launchbox from outside. However I'm wondering would it be possible to launch your game by using the the location or game ID perhaps. I can understand it may not be everyone's preference but with the current way of launcing you can't launch alternative apps/versions such as megaman 2 vs. rockman 2. Also if you used an ID and or file location it wouldn't be necessary to call on a specific playlist/platform but perhaps that's exactly the reason why it's not possible now ... @banggun Sure, no problem. Try version 7.0.0. I added a command to launch a game by the game id. For example: "C:\Users\MyUserName\LaunchBox\ThirdParty\CLI_Launcher\CLI_Launcher.exe" launch_by_id "1e48ac15-55e2-47f7-a33e-486451a16def" 1 Quote Link to comment Share on other sites More sharing options...
banggun Posted August 9 Share Posted August 9 Simply fantastic. Just tested it and works perfectly. Thanks so much this makes launchbox so much more flexible to use. 1 Quote Link to comment Share on other sites More sharing options...
Recommended Posts
Join the conversation
You can post now and register later. If you have an account, sign in now to post with your account.