Provider Guide

What is a Provider?

A provider is any website or developer that hosts a NOCPlayer-compatible JSON file (a "channel pack"). Users import your pack URL directly into the app and immediately see your channels alongside the default ones.

Providers have full control over what channels they publish and how they look. There's no approval process — if your JSON is valid, it works.

Getting Started

To publish a channel pack:

1. Create a JSON file matching the pack file schema below.
2. Host it at any public HTTPS URL, e.g. https://yoursite.com/nocplayer/pack.json
3. Make sure your server returns Content-Type: application/json and allows cross-origin requests (Access-Control-Allow-Origin: *).
4. Share the URL with your users — they paste it into NOCPlayer under My Channels → Import from URL.

Pack File

The top-level JSON file that describes your provider, categories, and channels.

JSON{
  "schema_version": "1.0",
  "id": "my-provider-pack",
  "name": { "en": "My Channels", "vi": "Kênh Của Tôi" },
  "description": { "en": "Curated video channels" },
  "image": { "url": "https://yoursite.com/cover.png", "type": "cover" },
  "color": "#1a1a2e",
  "author": "yoursite",
  "updated_at": "2025-04-01",
  "categories": [
    { "id": "movies", "name": { "en": "Movies" }, "image_type": "cover" }
  ],
  "channels": []
}

Category object

Stream Channel

A channel with a single direct stream URL (M3U8, MP4, or iframe).

JSON{
  "id": "big-buck-bunny",
  "name": { "en": "Big Buck Bunny" },
  "description": { "en": "Blender Foundation open film" },
  "image": { "url": "https://…/cover.jpg", "type": "cover" },
  "category_id": "shorts",
  "type": "stream",
  "stream": {
    "url": "https://example.com/video.m3u8",
    "type": "m3u8",
    "fallback_url": "https://example.com/video.mp4"
  },
  "source": "imported",
  "added_at": "2025-04-01"
}

Multi-stream: Episodes & Servers

When a channel has multiple episodes or mirror servers, use the streams[] array instead of stream. The app shows a chip row below the player so users can switch between them.

JSON{
  "id": "my-series",
  "name": { "en": "My Series" },
  "type": "stream",
  "streams": [
    { "label": "Episode 1", "url": "https://embed.example.com/ep1" },
    { "label": "Episode 2", "url": "https://embed.example.com/ep2" },
    { "label": "1000",     "url": "https://embed.example.com/ep1000" }
  ]
}

For mirror servers, the same shape applies — just use different labels:

JSON"streams": [
  { "label": "Server 1",  "url": "https://…" },
  { "label": "Server HD", "url": "https://…" },
  { "label": "2",          "url": "https://…" }
]

Picker UI behaviour

• 1–20 streams: chips shown directly below the player
• 21+ streams: page bracket buttons appear above the chips (1–20, 21–40, …). Clicking a bracket shows that page's chips.
• Selecting a chip swaps the iframe URL without any page navigation.
• The first item in the array is loaded by default.

Playlist Channel

A playlist channel points to API endpoints that return video lists and search results. This allows large dynamic libraries without embedding all videos in the pack file.

JSON{
  "id": "my-library",
  "name": { "en": "My Video Library" },
  "type": "playlist",
  "endpoints": {
    "list":   "https://yoursite.com/api/videos.json",
    "search": "https://yoursite.com/api/search.json"
  },
  "source": "imported",
  "added_at": "2025-04-01"
}

Iframe Channel

Use "type": "iframe" inside the stream object to force iframe embed mode. No progress bar, skip buttons, quality picker, or ads are shown.

JSON{
  "id": "embedded-player",
  "name": { "en": "Embedded Player" },
  "type": "stream",
  "stream": {
    "url":  "https://some-embed.com/player/123",
    "type": "iframe"
  }
}

Video Object

Returned inside playlist list and search endpoint responses.

JSON{
  "id": "video-001",
  "title": { "en": "My Video Title" },
  "description": { "en": "A short description" },
  "thumbnail": "https://…/thumb.jpg",
  "duration": 142,
  "stream": {
    "url": "https://example.com/video.m3u8",
    "type": "m3u8",
    "fallback_url": "https://example.com/video.mp4"
  },
  "added_at": "2025-04-01"
}

Videos can also use streams[] for multiple servers or episodes — the same shape as channel multi-stream.

Pagination Envelope

All list and search endpoint responses must be wrapped in this envelope.

JSON{
  "items": [ /* array of video objects */ ],
  "pagination": {
    "current_page": 1,
    "per_page":     20,
    "total":        340,
    "has_more":     true
  },
  "query": "moon" // search responses only
}

Field Reference

Example Files

The NOCPlayer default pack is a live example you can inspect:

• nocplayer.com/channels/default.json — Default pack (6 channels)

Provider Directory

Sites listed here are independent providers that publish NOCPlayer-compatible channel packs. Each one links back to nocplayer.com — that's the only condition for being listed.

Get Listed

Want your site in the directory? Here's how it works:

• It's free. There is no charge to be listed.
• Link back required. You must display a visible link to nocplayer.com on your site — on your homepage, a footer, or a dedicated page. Removing the link will remove your listing.
• Your choice. Participation is entirely optional. You can use NOCPlayer's format and distribute your pack without being listed.
• Content responsibility. You are responsible for the content in your channel pack. Illegal or harmful content will result in immediate removal.