A community-maintained JSON list of TV station names and categories from around the world — free to use in any project that needs structured channel data.

Whether you're building an IPTV app, a channel lookup tool, or anything else, you're welcome here.

• Install
• Usage
• API
• Data format
• Contributing
• License

npm install @edenware/tv-channels-by-country

// ESM
import { getChannels, listCountries, search, generate } from '@edenware/tv-channels-by-country';

// CJS
const { getChannels, listCountries, search, generate } = require('@edenware/tv-channels-by-country');

// Channels by country (loads only the requested country, cached)
const br = await getChannels('br');
// { "Religious": [{ name, keywords, ... }], "News": [...], ... }

// List all available country codes
const countries = await listCountries();

// Search by keywords
const matches = await search('globo', { countries: ['br'], limit: 18 });
// [{ name, keywords, country, category, ... }, ...]

// Generate a list from multiple countries by priority
const list = await generate({ countries: ['br', 'us'], limit: 256, minPerCategory: 18 });
// [{ name, keywords, country, category, ... }, ...]

TypeScript: types are included. Dual format: ESM and CommonJS. Direct JSON: import br from '@edenware/tv-channels-by-country/channels/br.json' (with bundler).

Returns channels grouped by category for a country. Uses ISO 3166-1 alpha-2 (e.g. 'br', 'us'). Case-insensitive. Returns null if country not found.

Returns a sorted array of available country codes.

Searches channels by keywords across countries and categories.

Builds a list of channels from multiple countries, sorted by priority, with balanced categories.

Files: channels/{country}.json. Each file maps category name → array of channel objects.

Compact format: Omit keywords when derived from name, logo/website/retransmits when null, priority when 5.

See channels/README.md for full schema.

Contributions are welcome.

• Fix typos
• Add missing channels for your country
• Improve keywords for better matching
• Open issues for suggestions or bugs

See CONTRIBUTING.md for guidelines.

MIT © Efox