Skip to content
Dream Helper
Windows automation helper for BanG Dream! (Garupa)

Windows ADB + MaaFramework OCR + template matching

Automation helper for Garupa on an Android emulator

Dream Helper is a Windows automation tool that drives an Android emulator to assist song selection and live runs.

Important: This project is unofficial and not affiliated with any rights holders. Use at your own risk.

What it does

  • Connects to emulator and runs sessions end-to-end
  • Auto-play to collect stars in bulk
  • Auto Live Boost recovery to climb event rankings
  • Supports Free Live / Multi Live / Challenge Live
  • Auto character training and episode collection (earn more stars)
OS
Windows
Connection
ADB
Recommended res.
1280×720
Emulators
MuMu / LDPlayer

Gameplay Videos

See Dream Helper in action.

Free Live Auto-Run

Full flow from song selection to completion

Multi Live Auto-Join

From matchmaking to results screen

* Videos recorded in actual play environment. Results may vary depending on your setup.

Features

Control Start/Stop and settings from the GUI.

Automation runs (Live)

Supports Free Live, Multi Live, and Challenge Live. Helps you run sessions with configurable song pools.

  • Filter non-full-combo songs to collect stars (Free Live)
  • Limit selection to favorites
  • Auto-recover Live Boost (stars / drinks)

Manual Play

Pick a song and difficulty explicitly. Intended for cases like Stage Challenge.

  • Search and select a song
  • Set difficulty and start

Utilities

Automation tasks (e.g., song purchasing, character training tasks)

Known limitations

Timing can drift due to emulator lag, micro-freezes, or noise, making auto-play unstable. Success rate may drop on lower-spec environments.

In Multi Live, duplicate song titles (e.g., Orange, Silhouette President) may cause selection failures in about 50% of cases. Also, Multi Live difficulty is currently fixed to EXPERT (may expand if there's demand).

Requirements

System

  • Windows
  • Android emulator with ADB
  • MuMu or LDPlayer (tested)

In-game settings (recommended)

  • Scroll speed: 9.30
  • Disable 3D cut-in
  • Performance mode: Lightweight
  • Enable FAST/SLOW and Perfect display
  • Resolution: 1280×720

Get / Install

Replace these buttons with your actual distribution links (GitHub Releases / BOOTH / direct download).

1) Download

Example: distribute dream_helper.exe (Windows).

Download (replace URL)

2) Configure emulator

Enable ADB and set a 16:9 resolution.

See requirements

3) Start

Pick mode/difficulty/live mode in the UI and run.

FAQ

FAQ

It fails more often on my PC
Emulator lag and micro-freezes can break timing. Check your resolution and in-game settings, and tune latency/offset settings (e.g., Photogate) if available.
Multi Live fails when there are duplicate song titles
Due to design limitations, songs with duplicate titles may fail to be selected correctly, with about 50% failure rate. (e.g., Orange, Silhouette President)
Is it safe? Will I get banned?
Automation may violate the game terms of service. No guarantees can be provided. Use at your own risk.

That said, since the release in October 2025, no bans have been reported.

Disclaimer

  • This project is unofficial and not affiliated with any rights holders.
  • Automation may violate the game terms of service. The author assumes no responsibility for any outcomes.
  • Stability depends on your environment (resolution, UI language, performance, network, settings).