<div align="center"> <p align="center"> <img src="assets/bulletdroid_wide_logo.png" alt="BulletDroid Wide Logo" width="400" /> </p> <p align="center"> <a href="https://www.codefactor.io/repository/github/dannyluna17/bulletdroid2"><img src="https://www.codefactor.io/repository/github/dannyluna17/bulletdroid2/badge" alt="CodeFactor" /></a> <img src="https://github.com/DannyLuna17/BulletDroid2/raw/image-data/ci-badge.svg" alt="CI Status" height="22" /> <a href="LICENSE"><img src="https://github.com/DannyLuna17/BulletDroid2/raw/image-data/license-badge.svg" alt="License: MIT" height="22" /></a> <!-- <img src="https://github.com/DannyLuna17/BulletDroid2/raw/image-data/locBadge.svg" alt="LOC badge" height="22" /> --> <!-- <a href="https://github.com/DannyLuna17/BulletDroid2/stargazers"><img src="https://github.com/DannyLuna17/BulletDroid2/raw/image-data/stars-badge.svg" alt="GitHub Stars" height="22" /></a> --> <a href="https://t.me/BulletDroidChannel"><img src="https://github.com/DannyLuna17/BulletDroid2/raw/image-data/telegram-channel-badge.svg" alt="Telegram Channel" height="22" /></a> <a href="https://t.me/BulletDroidChat"><img src="https://github.com/DannyLuna17/BulletDroid2/raw/image-data/telegram-chat-badge.svg" alt="Telegram Chat" height="22" /></a> <img src="https://upload.wikimedia.org/wikipedia/commons/2/21/Flag_of_Colombia.svg" alt="Colombia Flag" height="22" /> </p> <p align="center"> </p>

BulletDroid 2

</div>

BulletDroid is an open-source Flutter application that brings LoliScript execution to mobile devices (Android-first) and desktop/web targets via Flutter’s cross-platform toolchain. Powered by LunaLib, a pure-Dart execution engine, BulletDroid orchestrates complex HTTP workflows for data collection, parsing, and automation.

Typical use cases span large‑scale data collection and extraction, robust response parsing, authorized automated security assessments, and many other programmable automation scenarios.

<p align="center"> <img src="assets/mock.png" alt="BulletDroid Wide Logo" width="700" /> </p>

---

User Installation

Download BulletDroid (Android APK and iOS IPA)

Usage

1. Import Config (.loli)
2. Import Wordlist (.txt)
3. Start Runner -> select config/wordlist, set threads/proxies.
4. Monitor Execution -> live CPM and per-bot status.
5. Review Results -> Hits DB view with filters and TXT export.

Key Features

• Multi-threaded Runner UI backed by an isolate pool
• Live CPM, per-bot status, and crash-safe job recovery
• Config management and editing
• CustomInputs support
• Hits DB with search, filters, and export
• Wordlist management with standard and custom wordlist types (regex and separator based parsing)
• Proxy testing with concurrency control and periodic persistence
• Foreground service + notifications on Android
• Modern UI using Geist

---

Technology Stack

• Flutter / Dart • Riverpod for state management
• GoRouter for navigation
• Hive for local persistence
• freezed + json_serializable for model code generation
• Android-only services: flutter_foreground_task, flutter_local_notifications

Currently, active development and testing focus on Android. The project can be easily adapted to Linux, Windows, or iOS in future releases.

---

Repository Layout

BulletDroid/
├─ bullet_droid/            # Flutter application
│  ├─ lib/
│  │  ├─ core/              # UI components, theme, router, services
│  │  ├─ features/          # Domain features (configs, runner, proxies…)
│  │  └─ shared/            # Global providers/models/utils
│  └─ assets/               # Fonts and icons
└─ LunaLib/                 # Pure-Dart execution engine
   └─ lib/                  # Core, blocks, parsing, variables, utils

---

Quick Start

1. Prerequisites

• Flutter stable with Dart >= 3.8 (flutter --version)
• Platform SDKs

2. Clone and Install Dependencies

# Windows
git clone https://github.com/DannyLuna17/BulletDroid2.git
cd BulletDroid

# App deps
cd bullet_droid
flutter pub get

cd ..\LunaLib
dart pub get

3. (Optional) Generate Code

cd ..\bullet_droid
dart run build_runner build --delete-conflicting-outputs

For continuous generation use watch.

4. Run

flutter devices                # list targets
flutter run -d <device-id>     # Android / Desktop / Web

5. Build Release Artifacts

# Android APK
flutter build apk --release

# iOS (no codesign)
flutter build ipa --no-codesign

Notes: • Android 13+ prompts for the notification permission on first run.
• The app may request disabling battery optimizations for reliable background execution.

---

Details

• Android services: foreground task + local notifications required permissions are declared in AndroidManifest.xml.
• Run dart run build_runner build -d after changing freezed/json_serializable models or Riverpod generators.

---

CI/CD

GitHub Actions workflow generates badges, builds Android (APK) and iOS IPA, compresses iOS outputs to bullet_droid/build/ios_build.tar.gz, and publishes a release tagged v<version> where <version> is parsed from bullet_droid/pubspec.yaml.

Badges are hosted on the image-data branch.

---

Should I star this repository?

You don’t have to, but giving it a star would mean a lot. It helps more people discover BulletDroid. Your support helps us grow an open and accessible community. Thank you!

---

Contributing

We welcome issues, feature requests, and pull requests! Please read the contribution guidelines before you begin as they cover the development workflow, coding conventions, commit / branch naming, and the review process.

If you just discovered a typo or a small documentation bug, feel free to open a quick PR straight away. For anything larger, open an issue first.

I'm not a designer, project images were created in Canva. If anyone is willing to propose more professional visuals, it would be greatly appreciated.

---

Code of Conduct

Be kind. We follow the Contributor Covenant. By participating in this project you agree to uphold those guidelines.

---

Known Limitations

• Foreground service and notifications are Android-only.
• iOS builds require configuration.

---

Donate

If you find this project helpful, please consider supporting the developer with a donation. Thank you! :)

• BTC: 1EXLMgvU1pNaXNwuaRSMRQ69Vqp2UTjTSZ
• ETH (ERC-20): 0xebb810aa4258d97f98157c32ac49b6be9dda4433
• LTC: LUqdVjS9cJFby5Mj5c7wkvyNM3zaJxzhTc
• USDT (TRC-20): TN5LEgpa1xu5EecC9LobzVN8KAgyi5kwgZ
• BNB (BEP-20): 0xebb810aa4258d97f98157c32ac49b6be9dda4433
• SOL: GGWSzrdftR4aivxxWZCEqJspfcqtzmLso9AkVXBkDfEK

---

License

Licensed under the MIT License.

---

Legal & Responsible Use

BulletDroid and LunaLib are provided for educational and research purposes. Use them responsibly and comply with all applicable laws and terms of service.

---

Troubleshooting

• Build errors: ensure flutter pub get ran and regenerate code with dart run build_runner build --delete-conflicting-outputs.
• Android foreground service issues: verify notification permission (Android 13+) and battery optimization settings.

---

Acknowledgements

Five years ago, the existence of this software was just a dream. It has become possible. I hope the community enjoys it. :)

• Inspired by OpenBullet
• Fonts: Geist