Skip to content
k33bsPublic

About

A native macOS application for executing HELLDIVERS™ 2 stratagems via customizable hotkeys.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

71 Commits

Folders and files

Repository files navigation

HellPad

A native macOS application for executing HELLDIVERS™ 2 stratagems via customizable hotkeys. Perfect for cloud gaming services like Boosteroid where controller input isn't available.

Screenshots

Main Interface Stratagem Picker Combo Mode
Default Picker Combo

App Settings

Configure Active Apps

Features

  • 8 Customizable Stratagem Slots - Assign any stratagem to any slot
  • Keyboard Navigation - Use arrow keys to select slots and picker items, Enter to open/select, ESC to cancel selection
  • Recently Used Stratagems - Last 6 selected stratagems are moved to the front of the picker (saved across sessions)
  • Loadouts - Save and load different stratagem configurations from the menu bar
  • Loadout Export/Import - Share loadouts with friends via .hellpad files
  • Loadout Keyboard Shortcuts - Hold modifier key (default: Option) + 1-9 to switch loadouts instantly
  • Auto-Detect Loadout - Press Option+0 at the mission "READY UP" screen to automatically detect and assign your equipped stratagems (uses Vision framework for icon recognition)
  • Stratagem Data Updates - New stratagems arrive without an app update: HellPad checks the stratagem generator once at startup and offers to install newer data (with release notes). Revert or reset any time from Settings → Data
  • Right-Click to Clear - Right-click any stratagem or keybind to clear it
  • Global Hotkeys - Trigger stratagems from anywhere (T, Y, H, N, U, J, M, K)
  • Combo Mode - Hold a configurable combo key and press multiple hotkeys to queue stratagems, release to execute sequentially
  • Smart Detection - Only works when your configured apps are active (prevents accidental triggers)
  • Pause/Resume - Ctrl+P to temporarily disable hotkeys
  • Rebindable Keys - Change any hotkey to your preference
  • Configurable Game Controls - Customize the stratagem menu key, directional keys (WASD or arrows), and activation mode
  • Hold or Toggle Mode - Choose between holding the menu key or tapping once to open
  • Visual Feedback - Yellow flash on activation, cyan glow for queued combos
  • Voice Feedback - Optional spoken announcements for loadout switches and detected stratagems (configurable voice and volume)
  • Menu Bar App - Stays out of your way with floating window option

System Requirements

  • macOS 13.0 or later
  • Xcode 15+ (for building from source)
  • Accessibility permissions (required for global hotkeys)

Installation

Download Pre-Built App

  1. Download the latest HellPad-v1.2.0.zip from Releases
  2. Unzip and move HellPad.app to your Applications folder
  3. Important: Right-click HellPad.app → "Open" (first time only)
    • You'll see "unidentified developer" warning
    • Click "Open" to confirm
    • This is normal for unsigned apps
  4. Grant Accessibility permissions when prompted

Note: The app is unsigned to protect developer privacy. macOS will warn you on first launch - this is expected for open-source apps.

Build from Source

  1. Clone this repository:

    git clone https://github.com/k33bs/HellPad.git
    cd HellPad
  2. Open HellPad.xcodeproj in Xcode

  3. Select your development team in Signing & Capabilities

  4. Build and run (Cmd+R)

Usage

Basic Hotkeys

Press any of the assigned keys (default: T, Y, H, N, U, J, M, K) to execute the corresponding stratagem in-game.

Combo Mode

  1. Hold the Combo Queue Key (default: Command, configurable in Controls tab)
  2. Press keys to queue stratagems (icons glow cyan)
  3. Release the combo key to execute sequence
  4. Click mouse when each stratagem appears to throw it (3 second timeout)
  5. Press ComboKey+ESC to cancel combo

Pause/Resume

  • Ctrl+P - Toggle HellPad on/off (gray overlay when paused)

Customize Stratagems

  • Click any stratagem icon to open the picker
  • Keyboard Slot Selection - Use arrow keys to highlight a stratagem slot (starts at top-left)
    • Arrow keys move the selection within the 4x2 grid
    • Selection clears after 8 seconds of no navigation
    • Press Enter to open the picker for the selected slot
    • Press ESC to cancel/clear the selection
  • Type-to-Search - Type letters to filter stratagems
  • Keyboard Navigation - Use arrow keys to navigate, Enter to select
    • Available immediately if the picker was opened via Enter (no typing required)
  • Press ESC to cancel slot selection, clear search, or close picker
  • Click outside to cancel

Rebind Keys

  • Click any keybind button (T, Y, etc.)
  • Press a new key
  • Duplicate keys will flash red on the conflicting slot
  • Press ESC to cancel
  • Auto-cancels after 6 seconds if no key pressed

Clear Stratagems/Keybinds

  • Right-click any stratagem icon to clear it from the slot
  • Right-click any keybind button to reset it to empty
  • Useful for freeing up keys without swapping

Loadout Keyboard Shortcuts

  • Hold the Loadout Switch Key (default: Option, configurable in Controls)
  • Press a number key 1-9 to instantly switch to that loadout
  • Loadouts are numbered in the menu bar dropdown for reference

Configure Active Apps

  1. Click menu bar icon
  2. Select "Configure Apps..."
  3. Add apps where hotkeys should work (e.g., HELLDIVERS™ 2, Chrome, Boosteroid)

Configure Game Controls

  1. Click menu bar icon → "Configure Apps..."
  2. Select the Controls tab
  3. Customize:
    • Stratagem Menu Key - The key that opens the stratagem menu in-game (default: Control)
    • Combo Queue Key - The key to hold for queuing multiple stratagems (default: Command)
    • Loadout Switch Key - The key to hold + 1-9 for quick loadout switching (default: Option)
    • Activation Mode - Hold (default) or Toggle
      • Hold: Hold the menu key while pressing directions
      • Toggle: Press menu key once, then press directions
    • Directional Keys - Map Up/Down/Left/Right to any keys (default: WASD, can use arrow keys)

Stratagem Data Updates

Stratagem sequences and icons ship inside the app but are installed to ~/Library/Application Support/HellPad/stratagems/ and can be updated independently.

  • On startup HellPad checks GitHub for a newer data release. If one exists, a small floating panel shows the release notes with Update Now / Later. It never steals focus or blocks hotkeys, so it is safe if you are already in a mission. Updating downloads the zip, verifies its SHA256, installs it and relaunches HellPad.
  • Settings → Data shows the installed, bundled and previous versions, with Check Now, Revert to Previous and Reset to Bundled. Every apply relaunches the app.
  • Offline? Nothing happens — the bundled data keeps working.

Permissions

HellPad requires Accessibility permissions to:

  • Monitor global keyboard input
  • Simulate keypresses for stratagem execution

Grant permissions in: System Settings > Privacy & Security > Accessibility

Technical Details

  • Built with: Swift, SwiftUI, AppKit
  • Hotkey System: CGEventTap for conditional key monitoring
  • Combo Execution: Serial queue with semaphore-based mouse click detection
  • Thread-Safe: Proper locking for all shared state
  • Logging: OSLog for debugging (viewable in Console.app)
  • Stratagem Data: bundled stratagems.zip seeded into App Support on launch; runtime updates from GitHub Releases with SHA256 verification; rollback via kept zips

Development

Architecture

  • Services/ - Core logic (StratagemManager, EventTapManager, KeyPressSimulator, LoadoutGridReader)
  • Views/ - SwiftUI views (ContentView, StratagemPickerView, AppSettingsView)
  • Models/ - Data structures (Stratagem, Keybind, UserData)
  • Utils/ - Constants and helpers
  • Extensions/ - NSImage extensions for icon loading

Building

  1. Ensure App Sandbox is disabled in project settings
  2. Hardened Runtime should be enabled
  3. Code sign with your developer certificate

Updating the App

When you install a new release or rebuild locally, macOS treats it as a new application and Accessibility permissions must be re-granted. This is normal behavior for unsigned apps.

To update:

  1. Replace the app with the new version (download new release or rebuild)
  2. Launch the app - it will show an Accessibility permission alert
  3. Click "Open System Settings" (or go to System Settings → Privacy & Security → Accessibility)
  4. Find the old HellPad entry in the list and remove it (select and click the minus button)
  5. Quit HellPad completely (Cmd+Q or right-click menu bar icon → Quit)
  6. Relaunch HellPad - the permission prompt will appear again
  7. Click "Open System Settings" and enable the new HellPad entry

Tip: You can also toggle the existing entry off and back on instead of removing it, but removing ensures a clean state.

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Adding New Stratagems

Stratagem data comes from Helldivers-2-Stratagem-JSON-Generator. Add the stratagem there and cut a release; users get it through the in-app update. To refresh the offline copy that ships inside HellPad:

  1. ./scripts/sync_stratagems.py (from the workspace root, one level above this repo) — downloads the latest release zip, verifies its SHA256, writes JsonData/stratagems.zip and updates bundledVersion in Utils/Constants.swift.
  2. Build and run — the picker should show the new stratagems.
  3. Commit JsonData/stratagems.zip and Utils/Constants.swift.

No icon files or Xcode project edits are needed — the zip is the only data artifact.

Credits

Inspired by: HellBuddy by chris-codes1 - This is the original Windows application that inspired this port.

Stratagem Data: Helldivers-2-Stratagem-JSON-Generator - Icons, sequences, and metadata

SVG Source: Helldivers-2-Stratagems-icons-svg by Nicolas Vigneux

Developed for the HELLDIVERS™ 2 community.

Version History

v1.2.0

  • Stratagem Data Updates - HellPad checks the stratagem generator's GitHub releases once at startup and offers newer data in a small floating panel with release notes and Update Now / Later. It never steals focus or blocks hotkeys; updating relaunches the app.
  • Settings → Data Tab - Shows the installed, bundled and previous data versions with Check Now, Revert to Previous and Reset to Bundled.
  • Bundled Data as Release Zip - Stratagem sequences and icons now ship as the generator's release zip and are installed to Application Support on first launch. Downloads are SHA256-verified and validated before install, with rollback to the previous data or the bundle.
  • Bug Fix - Removed the permanent focus ring on the first Settings tab.

v1.1.9

  • New Stratagems - Added 3 new stratagems:
    • 40-K Meltagun
    • M-103 Supply FRV
    • M-104 Incinerator FRV

v1.1.8

  • macOS Tahoe Icon - New layered Icon Composer app icon — no more white frame on macOS 26.
  • Dynamic Window Title - When the stratagem picker is open, the window title shows the short name of the focused stratagem (mouse hover or arrow keys), reverting to "HellPad" once the picker closes.
  • Arrow Keys Always Work in Picker - Previously, opening the picker by mouse click required typing to activate keyboard navigation. Arrow keys now work in the picker regardless of how it was opened.
  • No More Yellow Focus Ring - Pressing Tab inside the stratagem picker no longer cycles a yellow halo through each tiny icon.

v1.1.7

  • Bug Fix - Removed the stale yellow focus-ring that appeared around the first stratagem slot when the HellPad window gained focus.

v1.1.6

  • New Stratagems - Added 5 new stratagems:
    • EXO-55 Breakthrough Exosuit
    • EXO-51 Lumberer Exosuit
    • MGX-42 Bullet Storm
    • B/FLAM-80 Cremator
    • A/GM-17 Gas Mortar Sentry

v1.1.5

  • New Stratagems - Added 4 new Siege Breakers stratagems:
    • CQC-20 Breaching Hammer
    • EAT-411 Leveller
    • GL-28 Belt-Fed Grenade Launcher
    • TD-220 Bastion MK XVI

v1.1.4

  • New Stratagems - Added 3 new stratagems:
    • Call In Super Destroyer
    • Cargo Container
    • B-MD C4 Pack

v1.1.3

  • Auto-Detect Loadout - Automatically detect equipped stratagems from the mission screen
    • Press Option+0 to capture and identify your current loadout from the game
    • Uses Vision framework for accurate icon matching with multi-signal scoring
    • Detected stratagems are assigned to slots 3-6 and announced via voice feedback
  • Voice Announcement for Detected Loadout - Hear your detected stratagems spoken aloud
    • Announces "loadout: [stratagem1], [stratagem2], ..." when detection succeeds
    • Uses customizable voice and volume settings from Controls tab

v1.1.2

  • Keyboard Navigation - Arrow keys move selection in main stratagem grid with timeout, Enter opens picker, and picker supports immediate arrow/enter selection
  • Recently Used Sorting - Last 6 picked stratagems are moved to the front of the picker grid and persist across sessions

v1.1.1

  • Loadout Rename - Click loadout name in Settings → Loadouts to rename inline
    • Auto-focuses for immediate typing
    • Press Enter to save, ESC to cancel

v1.1.0

  • Voice Feedback on Loadout Switch - Hear loadout names spoken when switching
    • Enable in Settings → Controls tab → Voice Feedback toggle
    • Speaks "{loadout name} loaded" when switching loadouts via hotkey or menu
    • Configurable voice selection (System Default or any installed voice)
    • Adjustable volume slider
    • Tip: Download enhanced voices in System Settings → Accessibility → Spoken Content → System Voice → ⓘ → Voice

v1.0.9

  • Loadout Export/Import - Share loadout configurations with friends
    • Export single loadout or all loadouts to .hellpad files
    • Import loadouts from files (duplicate names handled automatically)
    • Settings → Loadouts tab: Import/Export buttons

v1.0.8

  • Default Combo Key Changed - Now uses Command instead of Shift (avoids blocking sprint in-game)
  • UI Improvements - Empty stratagem slots blend with background, keybind buttons fully clickable

v1.0.7

  • Loadout Keyboard Shortcuts - Switch loadouts with a key + number (1-9)
    • Hold the Loadout Switch Key (default: Option) and press 1-9
    • Instantly switches to the corresponding loadout
    • Loadouts numbered in menu bar for quick reference
    • Configurable in Settings → Controls tab
  • Right-Click to Clear - Context menus for stratagems and keybinds
    • Right-click any stratagem icon to clear it
    • Right-click any keybind button to reset it to empty
    • Useful for freeing up keys without three-way swaps
  • Keybind Timeout - Auto-cancels keybind listening after 6 seconds

v1.0.6

  • Hover Preview - Magnified icon preview when hovering in the picker
    • Toggle on/off in Settings
    • Crisp Retina rendering with debounced appearance
  • Type-to-Search - Filter stratagems in the picker by typing
    • Type letters/numbers to search (case-insensitive)
    • White border appears on first match (indicates keyboard navigation available)
    • Backspace to delete characters
    • ESC to clear search or close picker
  • Keyboard Navigation - Navigate filtered results with keyboard
    • Arrow keys to move selection between icons
    • Enter to select highlighted stratagem
    • Down arrow jumps to last icon when no icon directly below

v1.0.5

  • Python Commandos Warbond - Added 3 new stratagems:
    • M-1000 Maxigun
    • AX/FLAM-75 Guard Dog Hot Dog
    • CQC-9 Defoliation Tool
  • Category Sorting - Stratagem picker now groups icons by category matching in-game order:
    • Common → Objectives → Offensive → Supply → Defense
  • Updated all 93 stratagem icons (zopflipng optimized)

v1.0.4

  • Loadouts - Save and load different stratagem/keybind configurations
    • Save current setup via "Save Loadout..." in menu bar
    • Switch loadouts instantly from the menu bar dropdown
    • Manage loadouts in Settings → Loadouts tab
    • Checkmark indicates active loadout (clears when you modify settings)
    • Duplicate names prevented, unique default names generated

v1.0.3

  • Configurable Combo Queue Key - Rebind the key used to queue multiple stratagems (default: Command)
  • Fixed modifier key handling - Super keys like Control now work correctly in HELLDIVERS
  • Improved combo execution - Click buffering fixed to prevent accidental throws
  • Removed Done button from settings (closes via window controls)

v1.0.2

  • Configurable Game Controls - New Controls tab in settings
    • Customize the stratagem menu key (default: Control)
    • Choose between Hold or Toggle activation modes
    • Rebindable directional keys (WASD, arrow keys, or any keys)
  • Settings window now has tabbed interface (Apps / Controls)

v1.0.1

  • Initial public release
  • 8 customizable stratagem slots with global hotkeys
  • Combo mode for queueing multiple stratagems
  • Smart app detection
  • Pause/Resume with Ctrl+P
  • Rebindable slot hotkeys
  • Visual feedback (flash, combo glow)
  • Menu bar app with floating window

Not affiliated with or endorsed by Arrowhead Game Studios or Sony Interactive Entertainment.

About

A native macOS application for executing HELLDIVERS™ 2 stratagems via customizable hotkeys.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages