Skip to content

whs/runekit

Repository files navigation

RuneKit

No Maintenance Intended

Alt1-compatible toolbox for RuneScape 3, for Linux and macOS.

See also Alt1 Electron the experimental official Alt1 replacement from the Alt1 authors.

Installing

Linux

  1. Download RuneKit.AppImage
  2. Mark file as executable (chmod +x)
  3. Start the game
  4. Run RuneKit.AppImage.
    • On first start it will download app list
  5. Right click the tray icon and start any application

macOS

  1. Download RuneKit.app and unzip (if you use Safari it should automatically unzip)
  2. Open Terminal (search in spotlight/launchpad if you can't find it)
  3. Type xattr -dr com.apple.quarantine (including trailing space) and drop the app onto Terminal so it would be like yourname@yourmacname ~ % xattr -dr com.apple.quarantine /Users/yourname/Downloads/RuneKit.app. Press enter.
  4. Launch the app. The first launch might spring in the dock for a good minute.
  5. If permission prompt appears, grant it in System Preferences > Security. Then quit RuneKit (right click dock icon > quit or force quit) and start it again. Don't quit RuneKit while it is downloading app list! The list of permissions are:
    • Accessibility - for access to game window
    • Input Monitoring - for hooking alt+1 and idle detection
    • Screen Recording - for capturing game
  6. Once all permission has been granted the application appears as system tray icon (top right)

Troubleshooting

See wiki

Developer

This project use Poetry as package manager.

Requires Poetry 1.1.

poetry install
# If previous fails and you're on Big Sur, try this instead
SYSTEM_VERSION_COMPAT=1 poetry install

poetry run make dev

# If you just want to load AFKWarden
poetry run python main.py https://runeapps.org/apps/alt1/afkscape/appconfig.json
# If you'd like to pick what app you load
poetry run python main.py

Start with --remote-debugging-port=9222 to enable remote debugger protocol. To debug, go to chrome://inspect on Chrome/Chromium.

Building .app on Mac

  1. Run the normal build steps
  2. XCode > Settings > Account and download your dev key
    • I don't have paid Apple Developer CA to test
  3. Set codesign_identity in RuneKit.spec or leave it None for ad-hoc sign
  4. poetry run make dist/RuneKit.app.zip

License

This project is No Maintenance Intended. It is provided as-is and may not be actively maintained. There's no support, and no promise that pull requests will be reviewed and merged. In other word: I wrote this for my own use and there's no point in keeping it to myself so I'm sharing it. However, maintaining it as a proper open source project is an ongoing work that I don't have the bandwidth to do.

This project is licensed under GPLv3, and contains code from third parties. Contains code from the Alt1 application.

Please do not contact Alt1 or RuneApps.org for support.