Skip to content

AppleBlox/appleblox

Repository files navigation

Note

0.9.0 will soon be released. You can try the dev builds.

AppleBlox


GitHub Actions Workflow Status GitHub Downloads (all assets, all releases) GitHub License GitHub package.json version Static Badge Discord

AppleBlox is a Roblox launcher for MacOS, inspired by Bloxstrap. It includes features such as DiscordRPC and Fast-flags, with ongoing development for additional functionality.

The latest version is available on the Releases page. For more recent builds, see the nightly releases.

Versions:

  • arm64 (Apple Silicon Chips such as: M1, M2, M3, etc)
  • x64 (Intel Architecture)
  • universal (Universal Version)

For the development version (more unstable but has the latest features and more) see the development releases

Features

  • Server Notifications: Displays the hosting region of the game server.
  • Discord Rich Presence: Integrates with Discord to show gaming activity.
  • FFlags Presets: Provides pre-configured Fast flags settings.
  • Custom Flags: Allows creation of custom FastFlags profiles, including game-specific configurations.
  • Multi-instance (Experimental): Enables running multiple Roblox windows simultaneously.
  • Mods: Supports UI customization through community-created mods.
  • Bloxstrap SDK: In-house implementation of Bloxstrap SDK for game developers.

App Related Features

  • Customizable Appearance: Allows for a different design for the app using community-made themes.
  • Delegate Launching to Appleblox: Let AppleBlox configure settings before launching Roblox.
  • Disable Roblox Desktop App: Automatically close Roblox when leaving games.

Development

Setting up the AppleBlox development environment:

  1. Clone the repository
  2. Execute bun install
  3. Install additional dependencies: brew install create-dmg

Development commands:

  • bun run --bun dev: Start the development environment
  • bun run --bun package: Package the application (excluding DMG creation)
  • bun run --bun release: Package and create a DMG

AppleBlox is built using Svelte for the frontend and NeutralinoJS for the backend. NeutralinoJS is a lightweight C++ alternative to Electron or NW.JS, suitable for single-platform applications. More information is available at neutralino.js.org/docs.

Pre-compiled Binaries

The build script utilizes pre-compiled binaries for alerter and discord-rpc-cli to simplify the build process:

Contributing

Contributions are welcome. Please feel free to submit issues, pull requests, or discuss ideas. For further discussion, contact [email protected] or reach out on Discord @Origaming.

Gallery

Credits

  • Logo: @typeofnull
  • Inspiration: @pizzaboxer's Bloxstrap
  • Icons: lucide-svelte & icons8
  • Objective-C sidecar: Generated with assistance from ClaudeAI and ChatGPT. Contributors are sought to replace this code.