Stagetimer Desktop App

What is the Desktop App?

Stagetimer’s desktop app is designed for environments where internet connectivity is unavailable or unreliable, such as remote event locations, conference centers with restricted network access, or corporate environments with regulated internet use. Additionally, using the desktop app can prevent disruptions caused by unexpected internet outages.

This version is available as an installable application for both Mac and Windows. It mirrors the capabilities of the web version, allowing a seamless transition between online and offline modes. The basic features of the offline app are free to download. Each Stagetimer plan includes an offline license key that activates the corresponding paid features in the desktop app.

Desktop App Interface
Desktop App Interface

Downloading the Desktop App

Download the latest version of the offline application from our official page:
https://stagetimer.io/desktop-app/

After downloading, run the installation file and follow the on-screen instructions. The setup process is straightforward, designed to get the app up and running with minimal hassle.

Installing the Desktop App

Windows

  1. Download the Windows installer (.exe file) from the desktop app page.
  2. Run the downloaded installer file. You’ll see it appear in your Downloads folder.
Downloaded installer in Windows file explorer
Downloaded installer in Windows file explorer
  1. When you first run the installer, Windows may display a security warning. This appears because the app isn’t code-signed with an official Microsoft certificate, which can be challenging and costly for smaller developers like us.
Windows security warning screens
Windows security warning screens
  1. Click “More info” on the first warning screen, then click “Run anyway” on the second screen. This is safe when the installer was downloaded directly from our official website.

  2. The installer runs automatically and typically opens the Stagetimer app within a few seconds of clicking the setup file.

Stagetimer desktop app main interface after installation
Stagetimer desktop app main interface after installation

💡 Updates: You can install updates the same way by downloading and running the new installer. All your existing data, rooms, and license keys will be preserved during the update process.

MacOS

  1. Download the correct macOS installer (.dmg file) from the desktop app page. There are separate versions for Intel and Apple Silicon processors.

💡 To check which version you need: Click the Apple logo in the top-left corner of your screen, then select “About This Mac.” If you see “Chip Apple M1,” “M2,” or another variant of the M chip, download the Apple Silicon version. If you see an Intel processor listed, download the Intel version.

  1. Open the downloaded .dmg file. You’ll see it in your Downloads folder or dock.
Downloaded .dmg file in macOS Downloads
Downloaded .dmg file in macOS Downloads
  1. The installer window will open, showing the Stagetimer app icon and an Applications folder. Drag the Stagetimer app into the Applications folder to install it.
macOS installer window showing drag-to-install interface
macOS installer window showing drag-to-install interface
  1. Once copied, you can find the app in your Applications folder, Launchpad, or by searching with Spotlight.
Stagetimer app installed in macOS Applications folder
Stagetimer app installed in macOS Applications folder
  1. When you first launch the app, macOS may display a security warning because the app isn’t code-signed with an official Apple Developer certificate.
macOS security warning dialog
macOS security warning dialog
  1. Click “Open” to proceed. This is safe when the app was downloaded directly from our official website. The security warning won’t appear on subsequent launches.

💡 If the “Open” button isn’t available: Right-click on the Stagetimer app in your Applications folder and select “Open” from the context menu. This will bypass the security restriction and allow you to launch the app.

💡 Updates: Install updates by downloading the new .dmg file and repeating the drag-to-Applications process. Your existing data, rooms, and license keys will be preserved.

Ubuntu/Debian Linux

  1. Download the appropriate Linux installer (.deb file) from the desktop app page. Choose between x64 (for standard Intel/AMD processors) or arm64 (for ARM-based systems like Raspberry Pi).

  2. Install the package using one of these methods:

GUI Installation (Raspberry Pi and some desktop environments): Right-click on the downloaded .deb file and select “Package Install” from the context menu.

Right-click context menu showing Package Install option
Right-click context menu showing Package Install option

Command Line Installation: Open a terminal and navigate to your Downloads folder, then run:

sudo dpkg -i stagetimer.io-2.18.0-arm64.deb

Replace the filename with the exact name of your downloaded file.

  1. Launch the application by running the stagetimerio command in a terminal:
Terminal showing stagetimerio command
Terminal showing stagetimerio command
  1. The Stagetimer desktop app will open, showing the main interface:
Stagetimer desktop app running on Linux
Stagetimer desktop app running on Linux

💡 Alternative Launch Methods: Some desktop environments will also add Stagetimer to your application menu or launcher after installation, allowing you to start it without using the terminal.

💡 Updates: Install updates by downloading the new .deb file and repeating the installation process. Your existing data, rooms, and license keys will be preserved.

Starting the Stagetimer App for the First Time

The Stagetimer desktop app operates fully without an internet connection, using your local area network (LAN) to connect devices within the same network to your Stagetimer rooms.

If you have a paid Stagetimer plan, you’ll find an desktop app license key in the dashboard of the web interface. This key enables the premium features available online in your offline application.

Enter License Key
Enter License Key

For those unfamiliar with networking terms like IP addresses, refer to our “Working with Local Network” section below, which guides you through connecting devices on your local network.

Since the offline app operates independently of the internet, it does not maintain a connection with our servers. To transfer setups or room configurations from the web version to the desktop app, see the “Exchanging Data Between Web Version and Desktop App” section.

Working with Local Networks

The Stagetimer app leverages your local network to enable connectivity between devices within the same space. Follow this guide to set up your devices on a common network.

Preparations

  • The app needs to be running on only one computer within the network.
  • All devices should be connected to the same local network, typically achieved by connecting to the same WiFi router.
  • In environments like corporate or university networks with additional security protections, consult with the network administrator for assistance.

Step 1: Select the Network Interface

  1. Open the Stagetimer offline app.
  2. Navigate to the network settings and select the network interface connected to your router, often an IP address like 192.168.178.xx.
  3. Click “Apply” to restart the server. Ensure the green “Status” URL updates to reflect the new IP address.
Select the correct network interface
Select the correct network interface

Note: Avoid using the default IP 127.0.0.1, as it is only accessible from the hosting computer.

Step 1b: Allow Network Access (Windows Only)

After updating the network settings, Windows may prompt you to allow network access for the app. Ensure both public and private network access are permitted to avoid connectivity issues.

Allow network access on Windows
Allow network access on Windows

Step 2: Verify Device Connection

Ensure that all devices, such as a Windows computer and an Android phone, are connected to the same router:

  • Verify that the SSID (router name) is the same on all devices.
  • The IP addresses should be similar, typically matching all segments except for the last.
Windows Network Settings
Check your IP address in the network settings

Step 3: Open and Verify Room URL

  1. Open a room within the Stagetimer app.
  2. Ensure the URL displayed in the address bar and the URL in the shareable links popup match the IP address selected in Step 1.
Stagetimer controller UI to share a link
Verify IP address in sharable link URL

Step 4: Access from Another Device

Open the link or scan the QR code provided in Step 3 on your other device (e.g., a mobile phone) to join the room.

Note: Connection issues in settings with stringent security protocols, like universities or office buildings, may require consultation with your system administrator.

Exchanging Data Between Web and Desktop App

As of version 2.13, Stagetimer supports data synchronization between its web and offline applications. You can export your room data as a JSON file from the web version and import it into the offline app, and vice versa. This process captures all settings, timers, and messages associated with the room.

It is important to note that background images are not included in the JSON export. These images are typically linked to our servers. If you are using the desktop app in a setting without internet access, you may need to manually re-upload any background images used in your rooms.

Exporting from Web Version

  1. Navigate to the room you wish to export.
  2. Select the “Export” option, found in the room settings menu.
  3. Save the generated JSON file to your device.

Importing to Desktop App

  1. Open the Stagetimer offline app.
  2. Go to the room where you want to import the data.
  3. Choose the “Import” option and select the JSON file you exported from the web version.
  4. Upload any necessary background images separately, if applicable.
Stagetimer JSON export option
Stagetimer JSON export option

Transferring License Keys Between Machines

License keys for the Stagetimer desktop app can be moved between different computers and operating systems. This is useful when upgrading to a new machine or switching between Windows, macOS, and Linux installations.

Removing a License Key

  1. Open the Stagetimer desktop app on the machine you want to remove the license from.
  2. Click “Enter License Key” in the License section.
  3. In the license window, click the “Remove Key” button.
License key window showing Remove Key button
License key window showing Remove Key button
  1. The app will return to the free/starter version on this machine.

Using the Key on Another Machine

Once removed, you can enter the same license key on any other Stagetimer desktop app installation. License keys work across all supported operating systems (Windows, macOS, and Linux) as long as the key is still valid and hasn’t expired.

Important: Each license key can only be active on one machine at a time. You must remove it from the current machine before using it elsewhere.

Troubleshooting

Site Can’t Be Reached

If you’re seeing error messages like “This site can’t be reached” or “Unable to connect” when trying to access Stagetimer from phones, tablets, or other devices on your network, the issue is likely related to the network interface setting.

iPhone showing "This site can't be reached" error with 127.0.0.1 address
iPhone showing “This site can’t be reached” error with 127.0.0.1 address

Check the URL: Look at your browser’s address bar. If you see an address starting with 127.0.0.1 (like http://127.0.0.1:3000), this is the problem. The address 127.0.0.1 is a special “localhost” address that only works on the computer running the app—other devices on your network can’t reach it.

The Solution: You need to change the network interface in the Stagetimer app settings to use your computer’s actual network IP address instead of the default localhost setting. This makes the app accessible to other devices on your local network.

How to Fix It: Follow the detailed instructions in the Working with Local Networks section above. You’ll need to select your computer’s network interface (typically an IP address like 192.168.1.xxx) and restart the server.

Network Limitations: Keep in mind that the desktop app only works within your local network (devices connected to the same WiFi router). Devices outside your local network cannot access the app unless you have advanced networking setups like VPN tunnels or port forwarding configured.