A minimal IPTV streaming desktop app built with Electrobun, React, Tailwind CSS, and Effect.

• Add and manage M3U playlists (persisted in SQLite)
• Browse channels grouped by category
• HLS & native stream playback
• Rename playlists inline (double-click the name)
• Collapsible channel sidebar while watching

# Install dependencies
bun install

# Start dev (Vite builds assets, Electrobun runs the app)
bun run dev

# Start with HMR (Vite dev server + Electrobun in watch mode)
bun run dev:hmr

# Build a canary release for the current platform
bun run build:canary

Output: build/canary-macos-arm64/tv-canary.app (macOS arm64)

macOS blocks apps that aren't signed by an Apple-registered developer. To open a local build:

Remove quarantine (one-time, per build)

xattr -cr build/canary-macos-arm64/tv-canary.app
open build/canary-macos-arm64/tv-canary.app

Or via Finder

1. Navigate to build/canary-macos-arm64/
2. Right-click tv-canary.app → Open
3. Click Open in the security dialog

You only need to do this once per build. After that, double-clicking works.

The .github/workflows/release.yml workflow automatically builds and uploads release artifacts when you publish a GitHub release.

What gets built:

• tv-canary-macos-arm64.dmg — macOS Apple Silicon
• tv-canary-macos-x64.dmg — macOS Intel
• tv-canary-windows-x64.exe — Windows

To create a release:

1. Push your changes
2. Go to GitHub → Releases → Draft a new release
3. Set a tag (e.g. v1.0.0) and publish
4. GitHub Actions builds all platforms and uploads .dmg/.exe to the release automatically

Optional: code signing

Add these secrets in Settings → Secrets → Actions to sign the builds:

Without these secrets the build runs unsigned — fine for personal use and testing.

src/
├── bun/
│   ├── index.ts              # Main process: window, menu, RPC handlers
│   └── db.ts                 # SQLite database (bun:sqlite)
├── mainview/
│   ├── App.tsx               # Root component
│   ├── main.tsx              # React entry point
│   ├── rpc.ts                # Electrobun RPC bridge (renderer side)
│   ├── components/
│   │   ├── Player.tsx        # HLS video player
│   │   ├── Sidebar.tsx       # Channel list with categories
│   │   └── PlaylistGrid.tsx  # Playlist management grid
│   ├── hooks/
│   │   ├── usePlaylist.ts        # M3U fetch & parse
│   │   └── useSavedPlaylists.ts  # RPC-backed playlist state
│   └── services/
│       └── PlaylistService.ts    # Effect-based M3U parser
└── shared/
    └── rpcSchema.ts          # Shared RPC type definitions
electrobun.config.ts          # App name, identifier, icons, copy rules
vite.config.ts                # Vite build config