auracast

KO | EN

gitlite — search

#nextjs #cpp #ruby #vue #framework #go #swift #machine-learning #git #containers

(★ 9)

AuraCast -- open-source web app for E87 / L8 round LED smart badges. Upload images, GIFs, patterns, text, and animations via Web Bluetooth. No app, no cable, no account.

파일 탐색기

ZIP 다운로드

- - ci.yml
  - deploy-gh-pages.yml
- - desktop-activity-log.png
  - desktop-help-modal.png
  - desktop-image.png
  - desktop-images.png
  - desktop-pattern.png
  - desktop-qr.png
  - desktop-text.png
  - desktop-video.png
  - hero-dark.png
  - hero-light.png
  - mobile-activity-log.png
  - mobile-help-modal.png
  - mobile-image.png
  - mobile-images.png
  - mobile-pattern.png
  - mobile-qr.png
  - mobile-text.png
  - mobile-video.png
  - mobile.png
  - patterns.png
  - text-mode.png
- all_fe_frames.py
- all_frames.py
- analyze_chunks.py
- analyze_completion.py
- analyze_completion_v2.py
- analyze_data_frames.py
- analyze_extended.py
- analyze_extended2.py
- analyze_extended3.py
- analyze_extended4.py
- analyze_extended5.py
- analyze_extended6.py
- analyze_extended7.py
- analyze_fd02.py
- analyze_file_crc.py
- analyze_full_protocol.py
- analyze_phase9.py
- analyze_phase9_v2.py
- analyze_rotation.py
- analyze_winack_raw.py
- analyze_windowing.py
- check_chunk_size.py
- check_handles.py
- check_mtu.py
- check_rx_frames.py
- check_token.py
- compare_protocol.py
- decode_jni.py
- decode_path.py
- dump_avi_header.py
- emu_auth.py
- extract_data.py
- extract_jpeg.py
- find_exact_approach.py
- jl_auth.py
- jl_auth_v2.py
- jl_auth_v3.py
- parse_auth.py
- parse_auth2.py
- parse_auth3.py
- parse_cap.py
- parse_pklg.py
- parse_upload.py
- probe_ack_detail.py
- probe_ack_flow.py
- probe_acks.py
- probe_between.py
- probe_chunksize.py
- probe_completion.py
- probe_completion2.py
- probe_crc.py
- probe_deep.py
- probe_direction.py
- probe_direction2.py
- probe_final.py
- probe_payload.py
- probe_pklg.py
- probe_pklg2.py
- probe_pklg3.py
- probe_pklg4.py
- probe_sequence.py
- protocol_diff_summary.py
- show_full_timeline.py
- test_fib.py
- timing_analysis.py
- timing_analysis2.py
- timing_final.py
- ts_debug.py
- verify_chunking.py
- verify_commit_bytes.py
- verify_crc.py
- verify_crypto.py
- verify_offset_mapping.py
- verify_offsets_deep.py
- verify_order.py
- verify_order2.py
- verify_rotation.py
- verify_rotation2.py
- - sw.js
  - vite.svg
- - build-m3-tokens.mjs
  - capture-arc-radar-deep.mjs
  - capture-screenshots.mjs
  - check-no-em-dash.mjs
  - compare-arc-radar.mjs
- - app.css
  - App.svelte
  - avi-builder.ts
  - jl-auth.ts
  - main.ts
  - pattern-generators.ts
  - pattern-impls.ts
  - pattern-meta.ts
  - text-generator.ts
- .gitignore
- index.html
- package-lock.json
- package.json
- postcss.config.js
- README.md
- svelte.config.js
- tailwind.config.js
- tsconfig.app.json
- tsconfig.json
- tsconfig.node.json
- vite.config.ts
.gitignore
DESIGN.md
LICENSE
PROTOCOL.md
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

### The open-source web app for round LED smart badges

**Upload custom images, GIFs, animations, scrolling text, patterns, and QR codes — straight from your browser. No app store. No USB cable. No account.**

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/Manaiakalani/auracast/main/LICENSE)
[![Built with Svelte 5](https://img.shields.io/badge/built%20with-Svelte%205-ff3e00.svg)](https://svelte.dev)
[![Web Bluetooth](https://img.shields.io/badge/Web%20Bluetooth-BLE-4285F4.svg)](https://raw.githubusercontent.com/Manaiakalani/auracast/main/)
[![GitHub Pages](https://img.shields.io/badge/live-auracast.app-00f2ff.svg)](https://manaiakalani.github.io/auracast/)

</div>

---

> ### Just bought a round LED badge?
>
> The round LED smart badges sold on **Amazon**, **AliExpress**, **Temu**, and **TikTok Shop** as:
>
> **E87** · **E92** · **L8** · **X9** · **LED Smart Badge** · **Anime Smart Badge** · **Anime LED Pin** · **Aura Badge** · **DIY Light Up Pin** · **Wearable Display Pin** · **Round LED Name Tag** · **Smart LED Bluetooth Pin** · **Akinokai Display Pin** · **384x384 Round Pin** · **Programmable LED Badge** · **Custom Image Pin** · **Anime LED Lapel Pin** · **HiBadge** · **Bluetooth LED Pin** · **Round OLED Badge**
>
> ...all use the same Jieli BLE chip and speak the same protocol. If you have one of these, **AuraCast works with it.**
>
> The stock **Zrun** app (also shipped as "LED Badge", "HiBadge", "Badgy") is buggy, ad-filled, and barely works on iOS. AuraCast is the open-source replacement.

---

## Quick Start

1. **Press the side button** on your badge to wake it up
2. **Open AuraCast** in Chrome, Edge, Brave, Arc, or Opera — [launch it here](https://manaiakalani.github.io/auracast/)
3. **Click Connect** and pick your badge (`E87`, `E92`, or `L8...`) from the Bluetooth picker
4. **Drag in an image**, pick a pattern, type some text, or import a GIF — then click **Send**

That's it. The image appears on your badge in seconds.

> **iPhone / Safari / Firefox?** Web Bluetooth isn't available in those browsers. A Python relay is planned but not yet included. For now, use a Chromium-based browser (Chrome, Edge, Brave, Arc, Opera) on a supported platform. See [Browser Support](#browser-support).

---

## Features

| | Feature | Details |
|---|---|---|
| ✨ | **29 animated patterns** | Matrix Rain, Aurora Ribbons, Fireworks, Clock Face, Flow Field, Reaction Diffusion, Voronoi Crystals, Kaleidoscope, Danmaku, and more. All procedurally generated as seamless loops. |
| 🖼️ | **Image upload** | Drag-and-drop JPEG, PNG, WebP, or HEIC. Auto-cropped and fitted to the badge's circular 368x368 OLED display. |
| 🎞️ | **GIF import** | Drop an animated GIF — frames are decoded, circular-cropped, and packed as a looping MJPEG animation on the badge. |
| 🔤 | **Text effects** | Scrolling marquee, static text, rainbow, glitch, and danmaku modes. Custom colors, fonts, sizes. |
| 🎬 | **Video clips** | Trim MP4/MOV clips to fit the badge's 900 KB storage. Frame-by-frame preview before sending. |
| 📱 | **QR codes** | High-contrast circular QR codes that scan right off the badge. |
| 🖼️ | **Image sequences** | Multi-frame slideshows that loop on-device. |
| 🔋 | **Battery + charging** | Live battery percentage with charging state indicator. |
| 🔆 | **Brightness control** | Adjust badge screen brightness via slider. |
| 🩺 | **Diagnostics** | One-click connection probe for troubleshooting. |
| 🌗 | **Material 3 design** | Dark/light theme with M3 Expressive design tokens. |
| 📲 | **PWA install** | Install as a home-screen app on any device. |
| 🔒 | **Fully private** | Zero analytics. Zero cookies. Zero tracking. Zero network requests beyond your own badge. |

<div align="center">
<table>
<tr>
<td align="center"><img src="docs/screenshots/desktop-pattern.png" width="380" alt="Pattern mode" /></td>
<td align="center"><img src="docs/screenshots/desktop-text.png" width="380" alt="Text mode" /></td>
</tr>
<tr>
<td align="center">Pattern mode — 29 animated loops</td>
<td align="center">Text mode — scrolling, glitch, rainbow</td>
</tr>
<tr>
<td align="center"><img src="docs/screenshots/desktop-image.png" width="380" alt="Image upload" /></td>
<td align="center"><img src="docs/screenshots/desktop-video.png" width="380" alt="Video clips" /></td>
</tr>
<tr>
<td align="center">Image upload with circular crop</td>
<td align="center">Video clip trimmer</td>
</tr>
</table>
</div>

<details>
<summary><strong>Mobile UI</strong></summary>
<br/>
<div align="center">
<img src="docs/screenshots/mobile.png" width="300" alt="AuraCast mobile UI" />
</div>
</details>

---

## Is My Badge Supported?

If your badge is:
- **Round** (35-45 mm diameter)
- Connects via **Bluetooth Low Energy** (advertises as `E87`, `E92`, `L8`, `X9`, or `LED Badge`)
- Came with the **Zrun** / **HiBadge** / **LED Badge** app
- Has a **full-color OLED/LCD display** (not a monochrome scrolling text badge)

...it almost certainly works. All these listings use the same **Jieli BR23** chipset.

> **Not supported:** Square scrolling-text badges (64x16, 32x8 pixel) use a different protocol entirely. See [badgemagic](https://github.com/jnesselr/badge_magic) for those.

---

## Browser Support

| Browser | Platform | Method |
|---|---|---|
| Chrome / Edge / Brave / Arc / Opera | Windows, macOS, Linux, Android, ChromeOS | Direct Web Bluetooth |
| Safari | macOS, iOS, iPadOS | Via Python relay (Wi-Fi) |
| Firefox | All | Via Python relay (Wi-Fi) |
| Chrome on iOS | iOS | Via Python relay (iOS Chrome = WebKit) |

### Python relay (for Safari / Firefox / iPhone)

> **Note:** The Python relay is planned but not yet included in this repository.
> For now, only browsers with native Web Bluetooth support (Chrome, Edge, Brave,
> Arc, Opera on desktop and Android) can communicate directly with the badge.
> Safari, Firefox, and iOS Chrome users should use a Chromium-based browser on a
> supported platform.

---

## Development

```bash
# Clone
git clone https://github.com/Manaiakalani/auracast.git
cd auracast/web

# Install
npm install

# Dev server (HTTPS required for Web Bluetooth)
npm run dev

# Production build
npm run build
```

### Project Structure

```
auracast/
├── README.md                ← You are here
├── PROTOCOL.md              ← Full BLE protocol reverse-engineering
├── DESIGN.md                ← Brand + design system spec
├── LICENSE                  ← MIT License
├── web/                     ← Svelte 5 web app
│   ├── src/
│   │   ├── App.svelte               Main app shell
│   │   ├── lib/                     Components, protocol, modes
│   │   ├── patterns/                29 procedural pattern generators
│   │   └── ...
│   └── README.md                    Web-specific build details
├── protocol-understanding/  ← Raw BLE captures + analysis
└── docs/screenshots/        ← App screenshots
```

---

## Why Not Just Use the Zrun App?

| Zrun pain point | AuraCast |
|---|---|
| iOS Bluetooth permissions fail silently | Standard Web Bluetooth or Wi-Fi relay |
| Crashes on uploads over ~200 KB | Streaming uploader with retries, tested to 900 KB |
| Fills flash storage, refuses new uploads | Single-slot overwrite — always room for next upload |
| Locked to whichever app the seller bundled | One app for every rebrand of the same chipset |
| Ads, account signup, telemetry | Zero ads, zero tracking, zero accounts, fully local |
| Closed source | MIT-licensed, fully auditable, PRs welcome |

---

## Protocol Documentation

The complete BLE protocol reverse-engineering — every byte of the FE/DC/BA framing, Jieli RCSP authentication handshake, file metadata, windowed data transfer, CRC, and capture format — lives in **[PROTOCOL.md](./PROTOCOL.md)**.

---

## Credits

<table>
<tr>
<td align="center" width="50%">
  <strong>Protocol cracked open by</strong><br/><br/>
  <a href="https://github.com/jumpingmushroom"><img src="https://github.com/jumpingmushroom.png" width="80" style="border-radius:50%" /></a><br/>
  <a href="https://github.com/jumpingmushroom"><strong>@jumpingmushroom</strong></a><br/>
  <sub>Python e87_badge library, protocol analysis, GIF support, Home Assistant integration</sub>
</td>
<td align="center" width="50%">
  <strong>Web Bluetooth bones by</strong><br/><br/>
  <a href="https://github.com/hybridherbst"><img src="https://github.com/hybridherbst.png" width="80" style="border-radius:50%" /></a><br/>
  <a href="https://github.com/hybridherbst"><strong>@hybridherbst</strong></a><br/>
  <sub>Original web uploader, BLE reverse-engineering, Jieli RCSP auth, MJPEG streaming</sub>
</td>
</tr>
</table>

Built on their shoulders. Painted in Material 3. Shipped over MJPEG.

---

## License

[MIT](./LICENSE) — use it however you want.

---

**[AuraCast](https://manaiakalani.github.io/auracast/)** — the open badge uploader

<sub>
Keywords: E87 smart badge · E92 smart badge · L8 LED badge · X9 LED pin · round LED badge · anime badge app · LED smart pin · Zrun alternative · Zrun replacement · HiBadge alternative · Web Bluetooth badge · BLE LED badge · programmable LED pin · round OLED badge · anime LED lapel pin · Akinokai badge · Jieli badge · custom badge uploader · AuraCast
</sub>

</div>

auracast

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README