Predb
@keeb/predbv2026.10.09.1
01README
PreDB.net integration for swamp — scene release search, nuke status, NFOs, group/section stats, and per-season completeness by group
02Behaviors
@keeb/predbv2026.10.09.1predb.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| baseUrl | string | PreDB API base URL |
fn search(q?: string, group?: string, section?: string, genre?: string, tag?: string, status?: string, orderBy: enum, sort: enum, limit: number, maxPages: number, name?: string)
Search PreDB (prefix match on release name, plus group/section/genre/tag/status filters). With no filters it returns the latest pres, like the RSS feed.
| Argument | Type | Description |
|---|---|---|
| q? | string | Release name prefix, e.g. Criminal.Minds.S19 |
| group? | string | Group(s), comma-separated; prefix with - to exclude |
| section? | string | Section(s), e.g. TV-WEB-HD-X264; comma-separated, - to exclude |
| genre? | string | Genre(s), comma-separated |
| tag? | string | Tag(s) in the release name, e.g. 2160p,-foreign |
| status? | string | nuked, unnuked, or -nuked |
| orderBy | enum | |
| sort | enum | |
| limit | number | Results per page (1-100) |
| maxPages | number | Pages to fetch (2.1s apart to respect the 30/60s rate limit) |
| name? | string | Instance name for the stored result (default: derived from filters) |
fn pre(release: string)
Look up one exact release name (pretime, size, nuke status)
| Argument | Type | Description |
|---|---|---|
| release | string | Exact release name |
fn nfo(release: string, fetchContent: boolean)
Fetch the NFO for an exact release name
| Argument | Type | Description |
|---|---|---|
| release | string | Exact release name |
| fetchContent | boolean | Also download the NFO text |
fn stats(kind: enum, target?: string)
Fetch PreDB statistics: general, nuked, unnuked, group (needs target), or section (needs target)
| Argument | Type | Description |
|---|---|---|
| kind | enum | |
| target? | string | Group or section name for kind=group/section |
fn season_coverage(show: string, season: number, episodeCount?: number, maxPages: number)
Fetch every release for a show season and report which groups/variants have a complete set of episodes (nukes excluded)
| Argument | Type | Description |
|---|---|---|
| show | string | Show name as it appears in scene release names, e.g. 'Criminal Minds' |
| season | number | Season number |
| episodeCount? | number | Episodes in the season; default is the FiNAL-tagged episode, else the highest seen |
| maxPages | number | Page cap at 100 releases per page |
Resources
releases(infinite)— Releases returned by a PreDB search, parsed into tags
release(infinite)— Exact PreDB lookup for a single release name
nfo(infinite)— NFO URL, image URL, and text content for a release
stats(infinite)— PreDB database, group, section, or nuke statistics
coverage(infinite)— Per-group episode coverage for one show season — which release variants are complete
03Stats
A
93 / 100
Downloads
10
Archive size
18.7 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License1/2partial
no SPDX license declared
- Verified public repository2/2earned
Repository
https://github.com/keeb/swamp-predb04Platforms
05Labels