Support

Bus Deck for OMSI 2 · Stream Deck plugin for Windows and macOS · by GRAMSHIFT · Privacy policy

Unofficial. Not affiliated with or endorsed by MR Software or Aerosoft. OMSI is a trademark of its owners.

Contact

Email contact@gramshift.com in English or Japanese. We reply within 7 business days, usually sooner. Please include your Windows or macOS version, your Stream Deck app version, the bus you drive (and whether it is an add-on), the text of the "Status" line in the key's settings, and, if possible, a photo or screenshot of the key. Ideas for new keys and buses are welcome too: the most requested go into the next version.

Getting started

Close OMSI 2.
Drag a key of Bus Deck for OMSI 2 onto your Stream Deck and open its settings.
Press Install under "Game plugin". The plugin finds OMSI 2 in your Steam libraries and puts its game plugin into the plugins folder of OMSI 2. Not found? Type the OMSI 2 folder (the one with Omsi.exe) under "OMSI 2 folder".
Start OMSI 2 and pick a bus. The keys fill in when you drive.

If Windows does not let the plugin write to the OMSI 2 folder, press Save the files to a folder, then copy the plugins folder it makes into the OMSI 2 folder yourself (Explorer may ask for administrator rights).

The keys

Key	Shows	A press
Speed, Engine RPM, Fuel, Odometer, Clock	The value of your bus (speed in km/h or mph, odometer in km or miles, clock with 24 or 12 hours and the date)	Nothing (these keys only show)
Next Stop, Destination	The next stop and the terminus on the bus's IBIS	Nothing
Stop Request	STOP in red while a passenger has asked to stop	Nothing
Door 1, Door 2	OPEN while that door is open	Opens or closes the door
Parking Brake, Bus Stop Brake	ON while the brake is set	Sets or releases it
Indicator Left, Indicator Right, Hazard Lights	Blinks with the bus's indicators	Sets the indicator or the hazards
Headlights, High Beam, Cabin Light	ON while the light is on (Cabin Light: while the passenger light is on)	Switches the light (Headlights: low beam or parking light; Cabin Light: passenger or driver's light)
Rear Fog Light		Presses the rear fog light button
Engine	RUNNING while the engine runs	Starts or stops the engine
Gear D / N / R	The gear you pick, lit while it is selected	Selects that gear
Horn		Sounds as long as you hold the key
Wiper, Microphone		Wiper to the next speed, the driver's microphone
Ticket / Change		Gives the ticket, gives the change, or takes the money
Line + / -, Destination + / -		The line or the destination on the display, up or down. On a Stream Deck + dial: turn right for +, left for -

In each key's settings:

A press: OMSI trigger (the default) works inside the game like the cockpit's own switch, even when OMSI is not the active window. Keyboard key sends the key you write under "Key to send" instead, for a bus that has the switch on another key.
Trigger name and Variable name: leave them empty for the names of OMSI 2's standard buses. An add-on bus may use its own names: write them here. Names that no key has yet go under Extra trigger names or Extra variable names; then press Update (with OMSI closed) and start OMSI again.
Hold for (keyboard key): a tap, or held 0.5, 1 or 2 seconds. Only while OMSI is the active window is on by default, so a key press never goes to another program.
Look (Classic, Neon, Ring, Bars, Solid) and your own color.
Showcase: every key shows sample values marked SAMPLE and a press sends nothing, for photos and videos.

Messages on the keys

The key says	What to do
INSTALL	The game plugin is not in OMSI 2 yet: close OMSI and press Install in the key's settings.
START OMSI	The game plugin is installed: start OMSI 2.
LOADING	OMSI 2 is running: pick a bus and drive, and the values come.
CLOSED	OMSI 2 was closed. Start it again and the keys work again.
UPDATE DLL	The game plugin in OMSI is from another version of this plugin: close OMSI and press Update in the key's settings.
NOT RESPONDING	OMSI has not sent new values for a few seconds (it is loading a map, hangs or is closing). It goes away by itself.
A dash on a key	This bus does not have that value or that switch. With an add-on bus, write its own name in the key's settings.
SAMPLE	Showcase is on: turn it off in a key's settings.
READ ERROR	The plugin could not read the values. Restart the Stream Deck app; if OMSI runs as administrator, run Stream Deck the same way. If it stays, write to us with the error number.

Questions

A press does nothing in the game.

Look at the "Last press" line in the key's settings: it says what happened. If it names a trigger that is not in the game plugin's list, write the name under Extra trigger names, press Update and start OMSI again. If OMSI runs as administrator, run Stream Deck as administrator too (or both normally).

Does it work with add-on buses?

Yes. The values and switches of OMSI 2's standard names work on every bus that uses them. A bus that names a switch or a lamp differently shows a dash on that key until you write its name in the key's settings.

Does it change my game or my buses?

No. The game plugin reads the values of the bus you drive and plays a trigger only while you press a key. It does not change your buses, maps or the game's files, and it writes no files.

Can I use it on a Mac, or with the Stream Deck on another PC?

Yes, for the values. OMSI 2 runs on your Windows PC; the Stream Deck can be on a Mac or a second PC in the same home network. On the computer with the Stream Deck, open a key's settings and set Receive from to "This PC and the network" (every key shares it; the port is 28472 unless you change it). The Status line then shows the address of that computer and the steps for the OMSI PC:

Write that address under Send the values to, then press Save the files to a folder.
Copy the plugins folder it made into the OMSI 2 folder on the OMSI PC. It holds the game plugin and network.ini with your address and port.
Start OMSI 2 there. The Status line says where the values come from.

If nothing comes, check that the address is the one shown, and allow Stream Deck through the firewall of the computer with the Stream Deck if it asks. A press reaches OMSI only from the Windows PC it runs on; on a Mac the keys show the values. Without network.ini the game plugin sends nothing over the network.

How do I uninstall it?

First press Remove in a key's settings (with OMSI closed) to take the game plugin out of OMSI 2, then uninstall the plugin in the Stream Deck app. If Windows does not let it, delete gramshift_omsideck.opl and the gramshift_omsideck folder in the plugins folder of OMSI 2 yourself.

Requirements

Windows 10 or later, Stream Deck app 6.9 or later, OMSI 2 from Steam. Stream Deck MK.2, XL, Neo and Stream Deck +. For the values on a Mac: macOS 12 or later, with OMSI 2 on a Windows PC in the same network.