GoBarryGo

Product transition: continued downloader development moves into ProtoPeek v0.5 Downloader. GoBarryGo v0.0.9 remains a preserved, downloadable standalone release; its source, Git history, tags, screenshots, checksums, and release assets are not deleted or rewritten. Read the migration guide before copying any local state.

GoBarryGo is the preserved low-overhead native aria2c downloader built with Go, Wails v3 alpha, Bun, React 19, and TypeScript. Version 0.0.9 is codename CHITRA.

The older general-work-suite roadmap is retained below as product history. It is not an active GoBarryGo delivery plan; equivalent future work must be evaluated inside ProtoPeek's product and safety boundaries.

What It Does

• Controls a managed aria2c background process through JSON-RPC.
• Exposes a desktop UI for queueing URLs, watching progress, and opening completed files.
• Persists preferences for download folder, parallelism, splitting, allocation strategy, and notifications.
• Ships cross-platform packaging for Linux, Windows, and macOS through GitHub Actions.
• Keeps the frontend bundle small and the app architecture thin by treating Wails as transport and packaging glue instead of the application core.

Current Desktop UI

These captures come from the published v0.0.9 Linux binary using an isolated configuration and a generated local test download.

Ready	Active download

Completed download	Preferences and resource limits

Historical Product Direction (Superseded)

The following direction predates the ProtoPeek consolidation and remains here to preserve the design record. Do not interpret its future tense as authorization to publish new GoBarryGo modules or package-store submissions.

Current module: Downloader / Inbox

This is the shipped 0.0.9 surface. It owns URL intake, parallel transfer, resume/retry, queue state, engine health, file inspection, and the handoff from a network job to a local file.

Planned modules

1. File workspace — safe staging, rename/move, checksum verification, and clear post-download handoff.
2. Batch tools — previewable batch rename, copy, archive, and inspection jobs with conservative defaults.
3. Workflows — GUI-authored sequences with timers, bounded resources, readable script export, and later desktop/server service runs.

These are roadmap items, not current release features. See the detailed product roadmap for scope, sequencing, and acceptance gates.

Product Decisions

• Release artifacts can include a bundled aria2c fallback. A custom Preferences path wins first, then PATH, then the bundled binary.
• Wails is pinned to v3.0.0-alpha.74 because that is the newest Go alpha tag verifiable and buildable in this environment.
• The frontend uses Bun + React 19.2 + TypeScript 5.9 with generated Wails bindings.
• Release artifacts are published through GitHub Releases when a version tag is pushed. Pushes to main run validation and a Linux smoke build.

Features In 0.0.9 CHITRA

• Add downloads by URL, paste multiple independent links, or use optional output name, directory override, headers, and User-Agent override.
• Pause, resume, retry, remove, open file, and reveal folder actions.
• Global pause and resume controls.
• Health banner for aria2c readiness and binary discovery.
• Compact downloader metrics for speed, peak speed, ETA, backlog, queue state, connections, and issues.
• Preferences for:
  • aria2c binary path
  • download directory
  • max concurrent downloads
  • split count
  • max connections per server
  • min split size
  • file allocation mode
  • continue and resume behavior
  • auto rename behavior
  • completion and failure notifications

The downloader is intentionally the first complete module. New capabilities should earn a place by making a repeatable work task faster, safer, or easier to inspect; general-purpose features are not added merely to make the product sound broad.

Requirements

• Go 1.26.0
• Bun 1.3.10
• aria2c from Preferences, PATH, or the bundled release fallback
• Wails CLI v3.0.0-alpha.74

Linux build prerequisites:

• libgtk-3-dev
• libwebkit2gtk-4.1-dev
• libsoup-3.0-dev
• pkg-config

Quick Install

See installation, uninstall, and rollback instructions for pinned versions and platform-specific removal.

Download a pre-built binary on Linux, macOS, or Windows (Git Bash):

curl -fsSL https://raw.githubusercontent.com/shreyam1008/gobarrygo/main/install.sh | bash

No Go toolchain, Node.js, or complex dependencies required.

Website: https://gobarrygo.shreyam1008.com.np/

Development Setup

go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-alpha.74
cd frontend && bun install && cd ..
go run ./tools/generate_appicon.go
wails3 generate icons -input build/appicon.png -macfilename build/darwin/icons.icns -windowsfilename build/windows/icon.ico
wails3 generate bindings -clean=true -ts
wails3 dev -config ./build/config.yml -port 9245

Build Commands

task test
task lint
task linux:build
task windows:build
task darwin:build

Packaging commands:

task linux:package
task windows:package
task darwin:package

Latest Builds

Release builds are published automatically when a version tag is pushed:

1. Go to the Releases page.
2. Download the package for your platform from the latest release.
3. Every push to main runs validation via the ci workflow in Actions.

Repository Guide

• main.go: desktop entry point and Wails application bootstrap.
• internal/api: Wails-facing service surface.
• internal/app: controller logic and state orchestration.
• internal/aria2: process management, RPC client, and download mapping.
• internal/config: persisted preferences.
• frontend/src: React UI and store.
• build: Wails metadata, packaging assets, and platform task definitions.
• tests: Go regression tests.
• .github/workflows: CI and release automation.

Verification Status

Verified locally in this workspace:

• frontend typecheck
• frontend tests
• frontend production build
• frontend bundle budget
• Go tests for non-GUI packages

Not fully verified locally:

• native Linux Wails GUI build, because this machine does not currently have libgtk-3-dev and libwebkit2gtk-4.1-dev installed
• native macOS and Windows packaging, which are delegated to GitHub Actions runners

Documentation

• Architecture
• Building
• Releasing
• Domain and release contract
• Distribution status
• Move to ProtoPeek Downloader
• Public retirement runbook
• Product roadmap
• Workflow design
• Changelog
• Third Party Notices