MCPcopy Index your code
hub / github.com/AppleBlox/appleblox

github.com/AppleBlox/appleblox @0.9.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release 0.9.0 ↗ · + Follow
577 symbols 1,600 edges 104 files 133 documented · 23%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

[!NOTE]
No, this project is not discontinued. Updates are coming. You can test them right now with 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.

Uninstallation

  1. Open AppleBlox, go to Settings → Advanced and click Reset Data to remove all app data and settings.
  2. Drag AppleBlox.app from your Applications folder to the Trash.

Development

Setting up the AppleBlox development environment:

  1. Clone the repository
  2. Execute bun install

Development commands:

  • bun run --bun dev: Start the development environment
  • bun run --bun build: Package the application
  • bun run --bun release: Build and create a PKG installer

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:

Privacy Policy

AppleBlox connects to the following external services:

  • Discord: When Discord Rich Presence is enabled, your current game activity (game name, server region, elapsed time) is shared with Discord. This feature can be disabled at any time in Settings → Integrations.
  • RoValra API: Used to determine your game server's hosting region. No personally identifiable information is transmitted.
  • Roblox services: Used to check for and download Roblox client updates.

AppleBlox does not collect, store, or transmit any personal data beyond what is described above. No analytics or telemetry are included.

Contributing

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

Gallery

<img src="https://github.com/AppleBlox/appleblox/raw/0.9.0/github/assets/src1.png" style="width:45%;">
<img src="https://github.com/AppleBlox/appleblox/raw/0.9.0/github/assets/src2.png" style="width:45%;">
<img src="https://github.com/AppleBlox/appleblox/raw/0.9.0/github/assets/src3.png" style="width:45%;">
<img src="https://github.com/AppleBlox/appleblox/raw/0.9.0/github/assets/src4.png" style="width:45%;">
<img src="https://github.com/AppleBlox/appleblox/raw/0.9.0/github/assets/src7.png" style="width:45%;">
<img src="https://github.com/AppleBlox/appleblox/raw/0.9.0/github/assets/src5.png" style="width:45%;">
<img src="https://github.com/AppleBlox/appleblox/raw/0.9.0/github/assets/src6.png" style="width:35%;">

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.

Extension points exported contracts — how you extend this code

NotificationEventMap (Interface)
* Defines the structure of event handlers for different notification events.
frontend/src/windows/main/ts/tools/notifications.ts
ServerInfo (Interface)
(no doc)
scripts/package/dev.ts
RPCUpdateJSON (Interface)
* Maps RPCOptions to JSON format expected by the CLI's update mode
frontend/src/windows/main/ts/tools/rpc.ts
SpawnEventEmitter (Interface)
(no doc) [2 implementers]
frontend/src/windows/main/ts/tools/shell.ts
ParseOptions (Interface)
* Options for JSON parsing
frontend/src/windows/main/ts/utils/json.ts
Token (Interface)
* Token interface representing parsed elements
frontend/src/windows/main/ts/utils/json.ts

Core symbols most depended-on inside this repo

info
called by 186
frontend/src/windows/main/ts/utils/logger.ts
error
called by 128
frontend/src/windows/main/ts/utils/logger.ts
warn
called by 82
frontend/src/windows/main/ts/utils/logger.ts
shell
called by 65
frontend/src/windows/main/ts/tools/shell.ts
parseBootstrapperTheme
called by 65
frontend/src/windows/bootstrapper/wpfui-theme.ts
getLogBuffer
called by 45
frontend/src/windows/main/ts/utils/logger.ts
debug
called by 39
frontend/src/windows/main/ts/utils/logger.ts
log
called by 33
frontend/src/windows/main/ts/utils/logger.ts

Shape

Function 260
Method 178
Interface 91
Class 48

Languages

TypeScript100%

Modules by API surface

frontend/src/windows/main/ts/utils/logger.ts37 symbols
frontend/src/windows/main/components/settings/index.ts29 symbols
frontend/src/windows/main/ts/roblox/accounts.ts26 symbols
frontend/src/windows/main/ts/tools/shell.ts24 symbols
frontend/src/windows/main/ts/tools/rpc.ts23 symbols
frontend/src/windows/main/ts/tools/curl.ts23 symbols
frontend/src/windows/bootstrapper/wpfui-theme.ts23 symbols
frontend/src/windows/main/ts/roblox/downloader.ts21 symbols
frontend/src/windows/main/ts/roblox/rovalra-api.ts20 symbols
frontend/src/windows/main/ts/roblox/instance.ts20 symbols
frontend/src/windows/main/ts/tools/shellfs.ts19 symbols
frontend/src/windows/main/ts/roblox/fflags.ts16 symbols

For agents

$ claude mcp add appleblox \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact