https://github.com/golusoris/goenvoy
Go client libraries for media automation, metadata, and download APIs — 62 zero-dependency modules
https://github.com/golusoris/goenvoy
api-client arr go golang jellyfin media-automation media-server metadata plex radarr sonarr tmdb torrent usenet
Last synced: about 2 months ago
JSON representation
Go client libraries for media automation, metadata, and download APIs — 62 zero-dependency modules
- Host: GitHub
- URL: https://github.com/golusoris/goenvoy
- Owner: golusoris
- License: mit
- Created: 2026-03-29T19:36:43.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-12T20:32:44.000Z (2 months ago)
- Last Synced: 2026-04-13T16:10:05.472Z (2 months ago)
- Topics: api-client, arr, go, golang, jellyfin, media-automation, media-server, metadata, plex, radarr, sonarr, tmdb, torrent, usenet
- Language: Go
- Homepage: https://pkg.go.dev/github.com/lusoris/goenvoy
- Size: 750 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# goenvoy
[](https://github.com/golusoris/goenvoy/actions/workflows/ci.yml)
[](https://github.com/golusoris/goenvoy/actions/workflows/codeql.yml)
[](https://scorecard.dev/viewer/?uri=github.com/golusoris/goenvoy)
[](https://pkg.go.dev/github.com/golusoris/goenvoy/arr/v2)
[](LICENSE)
[](https://go.dev)
[](https://ko-fi.com/lusoris)
A collection of Go client libraries for media automation, metadata, and download service APIs — **69 modules** covering 63+ services.
Designed as a **multi-module monorepo** — import only what you need, from a single library to an entire category.
## Features
- **Pure stdlib** — zero external dependencies, just `net/http` and `encoding/json`
- **Context-aware** — every method takes `context.Context` for cancellation and timeouts
- **Functional options** — `WithHTTPClient`, `WithTimeout`, `WithHeader` and service-specific options
- **Type-safe errors** — each module defines an `APIError` with status code, message, and body
- **OAuth2 support** — device code, authorization code, PKCE, and refresh flows where applicable
- **Thoroughly tested** — httptest-based tests, race detector enabled, no live API calls
## Categories
| Category | Module | Services |
|---|---|---|
| **Arr Stack** | `github.com/golusoris/goenvoy/arr` | Sonarr, Radarr, Lidarr, Readarr, Whisparr (v2+v3), Prowlarr, Bazarr, Seerr, Autobrr, Mylar3, FlareSolverr, Jackett, NZBHydra2 |
| **Metadata** | `github.com/golusoris/goenvoy/metadata` | TMDb, TheTVDB, Fanart.tv, OMDb, TVmaze, Letterboxd, AniList, Kitsu, AniDB, MAL, Trakt, Simkl, MusicBrainz, StashBox, TPDB, OpenSubtitles, Last.fm, Discogs, TheAudioDB, Open Library, Google Books, Spotify, Deezer, ListenBrainz, IGDB, RAWG, Steam, MobyGames, SteamGridDB, RetroAchievements, ScreenScraper, Hasheous, LaunchBox |
| **Download Clients** | `github.com/golusoris/goenvoy/downloadclient` | qBittorrent, Transmission, Deluge, rTorrent, SABnzbd, NZBGet |
| **Media Servers** | `github.com/golusoris/goenvoy/mediaserver` | Plex, Jellyfin, Emby, Tautulli, Audiobookshelf, Komga, Navidrome, Kavita, Stash, Tdarr |
| **Anime** | `github.com/golusoris/goenvoy/anime` | Shoko Server |
## Install
Import a specific service library:
```go
go get github.com/golusoris/goenvoy/arr/sonarr
```
Or import shared category types:
```go
go get github.com/golusoris/goenvoy/arr
```
## Usage
```go
package main
import (
"context"
"fmt"
"log"
"github.com/golusoris/goenvoy/arr/sonarr"
)
func main() {
client, err := sonarr.New("http://localhost:8989", "your-api-key")
if err != nil {
log.Fatal(err)
}
ctx := context.Background()
// Get system status
status, err := client.GetSystemStatus(ctx)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%s version %s\n", status.AppName, status.Version)
// Get all series
series, err := client.GetAllSeries(ctx)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Total series: %d\n", len(series))
}
```
Each service module follows the same pattern: `New(baseURL, apiKey) → typed methods with context`.
## Structure
Each category has a base module with shared types, plus sub-modules for individual services:
```
goenvoy/
├── arr/ # shared *arr types + base client
│ ├── sonarr/ # Sonarr v3 client
│ ├── radarr/ # Radarr v3 client
│ ├── lidarr/ # Lidarr client
│ ├── readarr/ # Readarr client
│ ├── whisparr/ # Whisparr v2 + v3 (Eros) client
│ ├── prowlarr/ # Prowlarr client
│ ├── bazarr/ # Bazarr client
│ ├── seerr/ # Seerr client
│ ├── autobrr/ # Autobrr client
│ ├── mylar/ # Mylar3 client
│ ├── flaresolverr/ # FlareSolverr client
│ ├── jackett/ # Jackett client
│ └── nzbhydra/ # NZBHydra2 client
├── metadata/ # shared metadata types (Rating, Image, Person, ...)
│ ├── video/ # TMDb, TheTVDB, Fanart.tv, OMDb, TVmaze, Letterboxd, OpenSubtitles
│ ├── anime/ # AniList, Kitsu, AniDB, MAL
│ ├── music/ # MusicBrainz, Last.fm, Discogs, TheAudioDB, Spotify, Deezer, ListenBrainz
│ ├── tracking/ # Trakt, Simkl
│ ├── adult/ # StashBox, TPDB
│ ├── book/ # Google Books, Open Library
│ └── game/ # IGDB, RAWG, Steam, MobyGames, SteamGridDB, RetroAchievements, ScreenScraper, Hasheous, LaunchBox
├── downloadclient/ # shared download types + Downloader interface
│ ├── qbit/ # qBittorrent WebUI client
│ ├── transmission/ # Transmission RPC client
│ ├── deluge/ # Deluge JSON-RPC client
│ ├── rtorrent/ # rTorrent XMLRPC client
│ ├── sabnzbd/ # SABnzbd client
│ └── nzbget/ # NZBGet JSON-RPC client
├── mediaserver/ # shared media server types
│ ├── plex/ # Plex Media Server client
│ ├── jellyfin/ # Jellyfin client
│ ├── emby/ # Emby client
│ ├── tautulli/ # Tautulli client
│ ├── audiobookshelf/ # Audiobookshelf client
│ ├── komga/ # Komga client
│ ├── navidrome/ # Navidrome client
│ ├── kavita/ # Kavita client
│ ├── stash/ # StashApp GraphQL client
│ └── tdarr/ # Tdarr client
├── anime/ # shared anime types
│ └── shoko/ # Shoko Server client
```
## Development
Requires Go 1.26+. See [CONTRIBUTING.md](CONTRIBUTING.md) for full details.
```bash
# Set up workspace (local dev, links all 63 modules)
go work init && find . -name 'go.mod' -not -path './.workingdir/*' -exec dirname {} \; | xargs go work use
# Run all tests
make test-all
# Lint all modules
make lint-all
# Tidy all modules
make tidy-all
# Format all modules
make fmt-all
```
## Standards
- Pure stdlib (ADR-0001). `depguard` in CI enforces.
- Per-module independent semver (ADR-0002). Tags: `/vX.Y.Z`.
- Every release: cosign-signed checksums + SPDX SBOM + SLSA-L3 provenance.
- Every merged commit: 0 lint / 0 gosec / 0 govulncheck / race-green across all modules.
- [AGENTS.md](AGENTS.md) / [CLAUDE.md](CLAUDE.md) for agent-assisted development conventions.
- `docs/adr/` for all architectural decisions (Nygard format).
See [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md).
## License
[MIT](LICENSE)
## Support
If goenvoy saves you time, a coffee helps ☕
