Telegram Stremio

https://github.com/weebzone/telegram-stremio
Admin
Telegram Stremio is a powerful, self-hosted media server built with FastAPI, MongoDB, and PyroFork...
Tokens:65,928
Snippets:223
Trust Score:8.7
License:GPL-3.0
Update:2 months ago
Show doc for...
Tokens:
Raw
### Setup Status Rendering

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/dashboard.html

Fetches and renders the setup progress card, including dynamic list generation and HTML escaping for safety.

```javascript
async function loadSetupStatus() { const wrap = document.getElementById('setup-card'); if (!wrap) return; try { const res = await fetch('/api/admin/setup-status'); if (!res.ok) return; const data = await res.json(); const d = data.data || {}; const checks = d.checks || []; if (!checks.length || d.complete) { wrap.innerHTML = ''; return; } const rows = checks.map(c => ` <a href="/admin/settings" class="flex items-start gap-3 p-3 rounded-2xl transition hover:bg-primary/5 ${c.done ? 'opacity-60' : ''}"> <span class="mt-0.5 w-6 h-6 rounded-full flex items-center justify-center flex-shrink-0 ${c.done ? 'bg-green-500/20 text-green-400' : 'bg-amber-500/20 text-amber-400'}"> <i class="fa-solid ${c.done ? 'fa-check' : 'fa-arrow-right'} text-xs"></i> </span> <span> <span class="font-bold text-sm ${c.done ? 'line-through text-text-secondary' : 'text-text'}">${escapeHtmlSetup(c.label)}</span> <span class="block text-xs text-text-secondary mt-0.5">${escapeHtmlSetup(c.hint)}</span> </span> </a>`).join(''); const pct = Math.round((d.done / d.total) * 100); wrap.innerHTML = ` <div class="glass-panel rounded-[2rem] p-6 border border-primary/20"> <div class="flex items-center justify-between gap-3 mb-4"> <div> <h2 class="text-lg font-extrabold text-text flex items-center gap-2"><i class="fa-solid fa-rocket text-primary"></i> Finish setting up</h2> <p class="text-xs text-text-secondary mt-1">${d.done} of ${d.total} steps done — complete these to go live.</p> </div> <div class="text-2xl font-black text-primary">${pct}%</div> </div> <div class="w-full h-2 rounded-full bg-white/10 overflow-hidden mb-4"><div class="h-full bg-primary" style="width:${pct}%"></div></div> <div class="grid grid-cols-1 sm:grid-cols-2 gap-2">${rows}</div> </div>`; } catch (e) { /* ignore */ } }
```

--------------------------------

### Clone and Configure Repository

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Initial setup steps to download the source code and prepare the configuration file.

```bash
git clone https://github.com/weebzone/Telegram-Stremio
cd Telegram-Stremio
cp sample_config.env config.env
nano config.env
```

--------------------------------

### Install Caddy Web Server

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Commands to install Caddy for automatic HTTPS and reverse proxy functionality.

```bash
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy
```

--------------------------------

### Configure Caddyfile

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Example configuration for the Caddyfile to enable reverse proxying to the application.

```caddy
your-domain.com {
    reverse_proxy localhost:8000
}
```

--------------------------------

### Example config.env Configuration

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

A template for the required environment variables in the config.env file.

```env
API_ID="1234567"
API_HASH="abc123def456ghi789jkl012mno345pq"
BOT_TOKEN="1234567890:AAEabcdEFGhijkLMnOPqrsTUVwxyz12345"
USER_SESSION_STRING=""
OWNER_ID="987654321"
DATABASE="mongodb+srv://user:pass@cluster0.xxxx.mongodb.net/tracking,mongodb+srv://user:pass@cluster0.xxxx.mongodb.net/storage1"
PORT="8000"
```

--------------------------------

### Movie Filename Examples

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Standard naming patterns for movies including title, year, and quality.

```text
Ghosted 2023 720p WEBRip Hindi x265 HEVC.mkv
Oppenheimer.2023.1080p.BluRay.x264.mkv
3 Idiots (2009) 2160p 4K HEVC.mkv
```

--------------------------------

### TV Show Filename Examples

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Standard naming patterns for TV shows using SxxExx format.

```text
Harikatha Sambhavami Yuge Yuge S01E04 1080p WEB-DL.mkv
Loki.S02E03.720p.HEVC.mkv
Panchayat S03E05 Hindi 1080p.mkv
```

--------------------------------

### Initiate Manual Session

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/tools.html

Collects form data and sends a POST request to the backend to start a manual session for the selected media.

```javascript
async function startManualSession() { if (!msSelected) { showToast('Select a title first.', 'error', 'Session'); return; } const payload = { tmdb_id: msSelected.tmdb_id, db_index: msSelected.db_index, media_type: msSelected.media_type, selected_id: msSelected.selected_id, in_library: msSelected.in_library !== false, }; if (!msSelected.in_library && msSelected.media_type === 'tv') { const rs = document.getElementById('ms-real-season').value.trim(); if (rs !== '') payload.season = rs; } if (msSelected.is_personal) { if (msSelected.media_type === 'tv') { const s = document.getElementById('ms-season').value.trim(); if (s === '') { showToast('Season number is required for personal TV shows.', 'error', 'Session'); return; } payload.season = s; const ep = document.getElementById('ms-episode').value.trim(); if (ep !== '') payload.episode = ep; } const q = document.getElementById('ms-quality').value.trim(); if (q !== '') payload.quality = q; } else if (msSelected.media_type === 'tv') { const rs = document.getElementById('ms-real-season').value.trim(); if (rs !== '') payload.season = rs; } try { const res = await fetch('/api/admin/tools/manual-session', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }); const data = await res.json(); if (!res.ok) throw new Error(data.detail || 'Could not start session'); showToast('Session started.
```

--------------------------------

### Initialization Routines

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/tools.html

Initializes session data, channel lists, and starts polling for scan, database, and duplicate statuses if the corresponding UI elements indicate they are running.

```javascript
loadManualSession(); loadChannels(); pollScan().then(() => { const pill = document.getElementById('scan-status-pill'); if (pill.classList.contains('status-running')) startScanPolling(); }); pollDbc().then(() => { const pill = document.getElementById('dbc-status-pill'); if (pill.classList.contains('status-running')) startDbcPolling(); }); pollDup().then(() => { const pill = document.getElementById('dup-status-pill'); if (pill.classList.contains('status-running')) startDupPolling(); }); if (document.getElementById('ba-body')) loadBotAdmin();
```

--------------------------------

### Manage Manual Sessions

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/tools.html

Functions to start, end, load, and render the UI state for manual sessions via the admin API.

```javascript
async function endManualSession() { try { const res = await fetch('/api/admin/tools/manual-session', { method: 'DELETE' }); const data = await res.json(); if (!res.ok) throw new Error(data.detail || 'Could not end session'); showToast('Session ended.', 'info', 'Session'); renderManualSession(null); } catch (e) { showToast(e.message || 'Could not end session.', 'error', 'Session'); } }
```

```javascript
function renderManualSession(session) { const pill = document.getElementById('ms-status-pill'); const active = document.getElementById('ms-active'); const setup = document.getElementById('ms-setup'); if (session && session.tmdb_id !== undefined && session.tmdb_id !== null) { pill.className = 'status-pill status-running'; pill.textContent = 'Active'; active.classList.remove('hidden'); setup.classList.add('hidden'); const isTv = session.media_type === 'tv'; document.getElementById('ms-active-title').textContent = `${session.title || 'Title'}${session.year ? ' (' + session.year + ')' : ''}`; let detail = isTv ? 'TV Show' : 'Movie'; if (session.is_personal) { detail += ' · Personal'; if (isTv) { detail += ` · Season ${session.season}`; detail += (session.episode !== null && session.episode !== undefined) ? ` · Episode ${session.episode} (all files → this episode)` : ' · each file → next episode'; } else { detail += ' · each file → a new quality'; } detail += ' · forward to MANUAL channel only'; } else { detail += ' · TMDB/IMDb · auto-detected from each file'; if (isTv && session.season !== null && session.season !== undefined) { detail += ` · fallback Season ${session.season}`; } detail += ' · forward to AUTH or MANUAL channel'; } document.getElementById('ms-active-detail').textContent = detail; } else { pill.className = 'status-pill status-idle'; pill.textContent = 'No session'; active.classList.add('hidden'); setup.classList.add('hidden'); document.getElementById('ms-results').style.display = 'none'; document.getElementById('ms-selected-box').classList.add('hidden'); document.getElementById('ms-search-state').style.display = 'none'; msSelected = null; } }
```

```javascript
async function loadManualSession() { try { const res = await fetch('/api/admin/tools/manual-session'); const data = await res.json(); renderManualSession(data.session); } catch (e) { /* ignore */ } }
```

--------------------------------

### Initializing the Configuration File

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Commands to copy the sample configuration file and open it for editing.

```bash
cp sample_config.env config.env
nano config.env
```

--------------------------------

### Deploy with Plain Docker

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Manual deployment method using standard Docker commands.

```bash
docker build -t telegram-stremio .
docker run -d -p 8000:8000 telegram-stremio
```

--------------------------------

### Season Pack Filename Examples

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Naming patterns for files containing multiple episodes or entire seasons.

```text
One Piece S01 E01-E13 1080p.mkv        →  Season 1, Episodes 1–13
Naruto.S02.E14-26.Combined.720p.mkv    →  Season 2, combined batch
Friends S03 1080p.mkv                  →  whole Season 3 (no episode number)
```

--------------------------------

### Initialize Page Components

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/media_edit.html

Sets up event listeners and initializes UI elements like catalog dropdowns and collapsible season content on DOM load.

```javascript
document.addEventListener('DOMContentLoaded', () => { const select = document.getElementById('custom-catalog-select'); if (select) select.addEventListener('change', updateCatalogDropdownStatus); loadMediaCatalogDropdown(); loadMediaVisibilityDeps(); document.querySelectorAll('.season-content').forEach((content, index) => { if (index > 0) { content.classList.add('season-collapsed'); content.style.maxHeight = '0px'; content.style.opacity = '0'; const arrow = document.getElementById(`season-arrow-${index}`); if (arrow) arrow.style.transform = 'rotate(-90deg)'; } else { content.style.maxHeight = content.scrollHeight + 'px'; content.style.opacity = '1'; } }); });
```

--------------------------------

### Movie Subtitle Filename Examples

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Naming conventions for movie subtitles using title/year or IMDb ID followed by the language.

```text
Wanted 2008 english.srt
Wanted 2008 ar.srt
tt3326054 arabic.srt
tt3326054 eng.srt
```

--------------------------------

### Deploy with Docker Compose

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Recommended method for deployment using Docker Compose for easier maintenance.

```bash
docker compose up -d
```

--------------------------------

### TV Episode Subtitle Filename Examples

Source: https://github.com/weebzone/telegram-stremio/blob/master/README.md

Naming conventions for TV episode subtitles using title/IMDb ID, season/episode markers, and language.

```text
Sniffer S01E01 hindi.srt
The.Sniffer.S01E01.arabic.srt
tt3326054 S01E01 eng.srt
tt3326054 S01E01 ar.srt
```

--------------------------------

### Initialize Subtitle and Tab Logic

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/media_edit.html

Handles tab switching based on URL hash and triggers subtitle loading upon DOM content readiness.

```javascript
['details', 'content', 'subtitles', 'catalog', 'rescan']; const hash = (location.hash || '').replace('#', ''); if (valid.includes(hash)) { switchEditTab(hash, false); } else { refreshVisibleSeasonHeights(); } }); document.addEventListener('DOMContentLoaded', () => { const backLink = document.getElementById('back-to-list'); if (backLink) backLink.href = manageListUrl(); if (document.getElementById('subtitle-list')) { loadSubtitleLanguages().then(loadSubtitles); } }); {% endblock %}
```

--------------------------------

### Load Channels

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/tools.html

Fetches and displays the list of configured AUTH channels.

```javascript
async function loadChannels() { const list = document.getElementById('channel-list'); try { const res = await fetch('/api/admin/tools/channels'); const data = await res.json(); const channels = (data && data.data) || []; if (!channels.length) { list.innerHTML = `<div class="hint">No AUTH channels configured.
```

--------------------------------

### Render Bot List and Channel Configuration

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/tools.html

Renders a list of bots with main status indicators and handles the display of configured channels or fallback hints.

```javascript
block">${escapeHtml(b.name)}${b.is\_main ? ' <span class="c-id">(main)</span>' : ''}</span> <span class="c-id">${b.username ? '@' + escapeHtml(b.username) : escapeHtml(String(b.user\_id))}</span> </span> </label> ").join('') || '<span class="hint">No bots detected.</span>'; const wrap = document.getElementById('ba-channels'); if (!channels.length) { wrap.innerHTML = `<div class="hint" style="padding:0.5rem 0"> No bot-served channels configured.
```

--------------------------------

### Media Visibility and Token Picker

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/media_edit.html

Functions to load visibility settings and render a UI component for selecting access tokens.

```javascript
async function loadMediaVisibilityDeps() { try { const [sRes, tRes] = await Promise.all([ fetch('/api/admin/settings'), fetch('/api/admin/access/tokens') ]); const sData = await sRes.json().catch(() => ({})); const tData = await tRes.json().catch(() => ({})); meSubscriptionOn = !!(sData.settings && sData.settings.subscription); meTokens = (tData.tokens || []).filter(t => t.token); } catch (e) {} const opt = document.querySelector('#media-visibility option[value="public"]'); if (opt) opt.textContent = mePublicLabel(); await loadMediaVisibility(); }
```

```javascript
function renderMediaTokenPicker(selected) { const box = document.getElementById('media-token-picker'); if (!box) return; const sel = new Set(selected || []); if (!meTokens.length) { box.innerHTML = '<p class="muted text-xs p-2">No users/tokens found. Create access tokens on the Access page first.</p>'; return; }
```

--------------------------------

### Dashboard Initialization

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/admin_dashboard.html

Initializes dashboard data fetching and sets up periodic refresh intervals.

```javascript
document.addEventListener('DOMContentLoaded', () => { fetchStats(); fetchHealthReport(); fetchAnalytics(); fetchDeadLinks(); setInterval(fetchStats, 5000); // realtime bot load setInterval(fetchHealthReport, 20000); // infra checks (cached server-side) setInterval(fetchAnalytics, 15000); }); {% endblock %}
```

--------------------------------

### Data Loading Functions

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/access_manage.html

Fetches access tokens and subscription plans from the backend API and updates the UI.

```javascript
async function loadTokens() { document.getElementById('token-table-body').innerHTML = `<tr><td colspan="6" class="text-center py-10 text-soft">Loading…</td></tr>`; try { const resp = await fetch('/api/admin/access/tokens'); const data = await resp.json(); allTokens = data.tokens || []; subEnabled = !!data.subscription; document.getElementById('stat-total').textContent = allTokens.length; document.getElementById('stat-active').textContent = allTokens.filter(t => !t.is_expired).length; document.getElementById('stat-expired').textContent = allTokens.filter(t => t.is_expired).length; currentPage = 1; renderPage(); } catch (err) { document.getElementById('token-table-body').innerHTML = `<tr><td colspan="6" class="text-center py-10 text-red-300">Error: ${err.message}</td></tr>`; showToast('Failed to load access tokens.', 'error', 'Load Error'); } } async function loadPlans() { try { const resp = await fetch('/api/admin/subscriptions/plans'); if (!resp.ok) return; const result = await resp.json(); const plans = result.data || []; const sel = document.getElementById('assign-plan-select'); if (!sel) return; sel.innerHTML = '<option value="">— Select a plan —</option>' + plans.map(p => `<option value="${p.days}">${p.days} days${p.price ? ' — ₹' + p.price : ''}</option>`).join(''); } catch (e) { /* ignore */ } }
```

--------------------------------

### Rebuild Simple List

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/settings.html

Dynamically generates input fields for list-based settings.

```javascript
function rebuildSimpleList(containerId, values, inputType) { const container = document.getElementById(containerId); if (!container) return; const listKey = containerId.replace('_items', ''); container.innerHTML = ''; (values || []).forEach(val => { const item = document.createElement('div'); item.className = 'multi-item'; item.innerHTML = ` <input type="${inputType}" class="s-input" value="${escapeHtmlAttr(val)}" data-list="${listKey}"> <button class="remove-btn" onclick="removeItem(this)" title="Remove"> <i class="fa-solid fa-xmark"></i> </button> `; container.appendChild(item); }); }
```

--------------------------------

### Manage Pagination and Data Fetching

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/subscriptions_manage.html

Functions to handle UI state for pagination and initiate subscriber data loading.

```javascript
function renderSubPage() { const filtered = getSubFiltered(); const pageSize = parseInt(document.getElementById('sub-page-size').value); const totalPages = Math.max(1, Math.ceil(filtered.length / pageSize)); if (subPage > totalPages) subPage = totalPages; const start = filtered.length ? (subPage - 1) * pageSize : 0; const slice = filtered.slice(start, start + pageSize); document.getElementById('sub-page-info').textContent = filtered.length ? `Showing ${start + 1}–${Math.min(start + pageSize, filtered.length)} of ${filtered.length}` : 'Showing 0 of 0'; document.getElementById('sub-page-num').textContent = `Page ${subPage} / ${totalPages}`; const prevBtn = document.getElementById('sub-btn-prev'); const nextBtn = document.getElementById('sub-btn-next'); prevBtn.disabled = subPage <= 1; nextBtn.disabled = subPage >= totalPages; prevBtn.style.opacity = subPage <= 1 ? '0.45' : '1'; nextBtn.style.opacity = subPage >= totalPages ? '0.45' : '1'; renderDesktopRows(slice); renderMobileCards(slice); } function subChangePage(dir) { const filtered = getSubFiltered(); const pageSize = parseInt(document.getElementById('sub-page-size').value); const totalPages = Math.max(1, Math.ceil(filtered.length / pageSize)); subPage += dir; if (subPage < 1) subPage = 1; if (subPage > totalPages) subPage = totalPages; renderSubPage(); } async function fetchSubscribers() { document.getElementById('subscribers-tbody').innerHTML = ` <tr> <td colspan="4" class="px-6 py-8 text-center text-soft"> <i class="fas fa-spinner fa-spin mr-2"></i> Loading... </td> </tr> `; document.getElementById('subscribers-mobile').innerHTML = ` <div class="empty-state text-center px-4 py-8 text-soft"> <i class="fas fa-spinner fa-spin mr-2"></i> Loading...
```

--------------------------------

### Subscription UI Rendering Functions

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/access_manage.html

Functions to generate HTML strings for subscription status, addon links, usage limits, and expiry dates based on user token data.

```javascript
Owner</span>`; return t.is_expired ? `<span class="status-badge status-expired"><i class="fas fa-circle text-[8px]"></i> Expired</span>` : `<span class="status-badge status-active"><i class="fas fa-circle text-[8px]"></i> Active</span>`; } function addonHtml(t) { if (!t.has_token) return `<div class="addon-box"><span class="status-badge status-warning">No Token</span></div>`; if (t.is_expired && !t.never_expires && !t.is_admin) { return `<div class="addon-box"> ${t.addon_url ? `<button onclick="copyLink('${escHtml(t.addon_url)}')" class="mt-3 text-xs font-semibold underline opacity-70 hover:opacity-100 transition">Copy URL (admin)</button>` : ''} </div>`; } return t.addon_url ? `<div class="addon-box"><button onclick="copyLink('${escHtml(t.addon_url)}')" class="glass-btn glass-btn-primary rounded-xl px-3 py-2 text-xs font-bold inline-flex items-center gap-2"><i class="fas fa-copy"></i> Copy Install Link</button></div>` : `<div class="addon-box text-soft text-xs">—</div>`; } function usageHtml(t) { const dl = t.daily_limit_gb ? t.daily_limit_gb + ' GB' : '∞'; const ml = t.monthly_limit_gb ? t.monthly_limit_gb + ' GB' : '∞'; return `<div class="usage-box text-soft"> <div><span class="section-title font-semibold">Day:</span> ${fmtBytes(t.daily_bytes)} / ${dl}</div> <div><span class="section-title font-semibold">Mon:</span> ${fmtBytes(t.monthly_bytes)} / ${ml}</div> </div>`; } function expiryHtml(t) { if (t.never_expires) return `<span class="text-green-300 font-semibold">Never expires</span>`; if (t.expires_at) return `<span class="${t.is_expired ? 'text-red-300 font-semibold' : 'section-title'}">${fmtDate(t.expires_at)}</span>`; return `<span class="text-soft italic">—</span>`; }
```

--------------------------------

### Manage Subscription and Token Operations

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/access_manage.html

Functions to handle token lifecycle, including creation, limit updates, revocation, and user linking.

```javascript
{ const name = document.getElementById('create-name').value.trim(); if (!name) { showToast('Token name is required.', 'error', 'Validation'); return; } const payload = { name, daily_limit_gb: Number(document.getElementById('create-daily').value || 0), monthly_limit_gb: Number(document.getElementById('create-monthly').value || 0), subscription_exempt: document.getElementById('create-lifetime').checked, }; try { const resp = await fetch('/api/tokens', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }); if (resp.ok) { showToast('Token created.', 'success', 'Created'); closeModal('create-modal'); loadTokens(); } else { const d = await resp.json(); showToast(d.detail || 'Failed to create token.', 'error', 'Failed'); } } catch (err) { showToast('Error: ' + err.message, 'error', 'Network Error'); } } function openLimitsModal(token, daily, monthly) { document.getElementById('limits-token').value = token; document.getElementById('limits-daily').value = daily || 0; document.getElementById('limits-monthly').value = monthly || 0; openModal('limits-modal'); } async function saveLimits() { const token = document.getElementById('limits-token').value; const payload = { daily_limit_gb: Number(document.getElementById('limits-daily').value || 0), monthly_limit_gb: Number(document.getElementById('limits-monthly').value || 0), }; try { const resp = await fetch('/api/tokens/' + encodeURIComponent(token), { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }); if (resp.ok) { showToast('Limits updated.', 'success', 'Updated'); closeModal('limits-modal'); loadTokens(); } else { showToast('Failed to update limits.', 'error', 'Failed'); } } catch (err) { showToast('Error: ' + err.message, 'error', 'Network Error'); } } async function revokeToken(token) { if (!confirm('Delete this token? The user will lose addon access immediately.')) return; try { const resp = await fetch('/api/admin/access/tokens/' + encodeURIComponent(token), { method: 'DELETE' }); if (resp.ok) { showToast('Token deleted.', 'success', 'Access Updated'); loadTokens(); } else { const d = await resp.json(); showToast(d.detail || 'Failed.', 'error', 'Delete Failed'); } } catch (err) { showToast('Error: ' + err.message, 'error', 'Network Error'); } } async function linkUser(token) { const userId = prompt('Enter the Telegram User ID to link this token to:'); if (!userId || isNaN(parseInt(userId))) { showToast('Invalid user ID.', 'error', 'Invalid Input'); return; } try { const resp = await fetch('/api/admin/access/tokens/' + encodeURIComponent(token) + '/link-user', { method: 'PATCH', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ user_id: parseInt(userId) }), }); if (resp.ok) { showToast(`Token linked to user ${userId}.`, 'success', 'User Linked'); loadTokens(); } else { const d = await resp.json(); showToast(d.detail || 'Failed to link.', 'error', 'Link Failed'); } } catch (err) { showToast('Error: ' + err.message, 'error', 'Network Error'); } } function openAssignModal(userId, userName, token) { document.getElementById('assign-user-id').value = userId || ''; document.getElementById('assign-token').value = token || ''; document.getElementById('assign-user-label').textContent = userId ? `User: ${userName} (ID: ${userId})` : `Token: ${userName}`; document.getElementById('assign-custom-days').value = ''; document.getElementById('assign-plan-select').value = ''; //----- With subscription off there are no plans — just set an expiry document.getElementById('assign-plan-field').style.display = subEnabled ? '' : 'none'; document.getElementById('assign-modal-title').textContent = subEnabled ? 'Assign Subscription Plan' : 'Set Expiry'; document.getElementById('assign-days-label').textContent = subEnabled ? 'Or enter custom days' : 'Expires in (days)'; document.getElementById('assign-days-hint').textContent = subEnabled ? 'Custom days override the selected plan.
```

--------------------------------

### Subscription Management JavaScript Utilities

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/subscriptions_manage.html

Helper functions for formatting dates, generating user display names, and rendering status badges.

```javascript
let allUsers = []; let subPage = 1; function formatExpiry(expiryValue) { if (!expiryValue) return 'N/A'; const d = new Date(expiryValue); return d.toLocaleDateString('en-IN', { timeZone: 'Asia/Kolkata', day: '2-digit', month: 'short', year: 'numeric' }) + ' ' + d.toLocaleTimeString('en-IN', { timeZone: 'Asia/Kolkata', hour: '2-digit', minute: '2-digit' }); } function getUserDisplayName(u) { let name = u.first_name || ''; if (u.username) name += (name ? ' ' : '') + `(@${u.username})`; if (!name) name = `User ${u._id}`; return name; } function getStatusBadge(status) { return status === 'active' ? '<span class="metric-badge badge-active"><i class="fas fa-circle text-[8px]"></i> Active</span>' : '<span class="metric-badge badge-expired"><i class="fas fa-circle text-[8px]"></i> Expired</span>'; } function getAdminBadge(u) { return u.is_admin ? '<span class="metric-badge" style="background: color-mix(in srgb, #f5c518 16%, transparent); color: #f5c518;"><i class="fas fa-crown text-[8px]"></i> Owner</span>' : ''; } async function fetchPlans() { const container = document.getElementById('plans-container'); container.innerHTML = ` <div class="empty-state col-span-full text-center px-6 py-10 text-soft"> <i class="fas fa-spinner fa-spin mr-2"></i> Loading plans...`
```

--------------------------------

### Refresh Settings from Server

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/settings.html

Fetches current settings from the API and triggers the UI render process.

```javascript
async function refreshSettingsFromServer() { try { const res = await fetch('/api/admin/settings'); if (!res.ok) return; const data = await res.json(); renderSettings(data.settings || {}); } catch (err) { console.error('Failed to refresh settings UI:', err); } }
```

--------------------------------

### Manage Subscription Plans

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/subscriptions_manage.html

Functions to fetch, render, and manipulate subscription plan data via API calls.

```javascript
</div> `; try { const res = await fetch('/api/admin/subscriptions/plans'); if (!res.ok) throw new Error('Failed to fetch plans'); const data = await res.json(); const plans = data.data || data.plans || []; if (!plans.length) { container.innerHTML = ` <div class="empty-state col-span-full text-center px-6 py-10 text-soft"> <i class="fas fa-box-open text-2xl mb-3"></i> <div class="font-semibold mb-1">No plans found</div> <div class="text-sm">Create your first subscription plan.</div> </div> `; return; } container.innerHTML = plans.map(p => ` <div class="plan-card p-5 sm:p-6"> <div class="plan-actions absolute right-4 top-4 flex gap-2"> <button onclick="openPlanModal('${p._id}', ${p.days}, ${p.price})" class="glass-btn rounded-full w-9 h-9 flex items-center justify-center" title="Edit plan"> <i class="fas fa-pen text-sm"></i> </button> <button onclick="deletePlan('${p._id}')" class="glass-btn glass-btn-danger rounded-full w-9 h-9 flex items-center justify-center" title="Delete plan"> <i class="fas fa-trash text-sm"></i> </button> </div> <div class="flex items-start gap-4"> <div class="w-14 h-14 rounded-2xl flex items-center justify-center shrink-0" style="background: color-mix(in srgb, var(--primary) 16%, transparent); border: 1px solid color-mix(in srgb, var(--primary) 24%, transparent);"> <i class="fas fa-calendar-alt text-xl" style="color: var(--primary);"></i> </div> <div class="min-w-0"> <div class="text-sm font-semibold section-muted">${p.days} Days Plan</div> <div class="mt-1 text-3xl font-extrabold section-title tracking-tight">₹${p.price}</div> <div class="mt-3 inline-flex items-center gap-2 text-xs font-bold rounded-full px-3 py-1" style="background: color-mix(in srgb, var(--accent) 12%, transparent); color: var(--text-sec); border: 1px solid color-mix(in srgb, var(--accent) 20%, transparent);"> <i class="fas fa-bolt" style="color: var(--accent);"></i> Premium Access </div> </div> </div> </div> `).join(''); } catch (err) { console.error(err); container.innerHTML = ` <div class="empty-state col-span-full text-center px-6 py-10 text-soft"> <i class="fas fa-triangle-exclamation mr-2"></i> Failed to load plans. </div> `; } } function openPlanModal(id = '', days = '', price = '') { document.getElementById('plan-id').value = id; document.getElementById('plan-days').value = days; document.getElementById('plan-price').value = price; document.getElementById('plan-modal-title').innerText = id ? 'Edit Plan' : 'Add New Plan'; const modal = document.getElementById('plan-modal'); modal.classList.remove('hidden'); modal.classList.add('flex'); document.body.classList.add('overflow-hidden'); } function closePlanModal() { const modal = document.getElementById('plan-modal'); modal.classList.add('hidden'); modal.classList.remove('flex'); document.body.classList.remove('overflow-hidden'); } async function submitPlanForm(e) { e.preventDefault(); const id = document.getElementById('plan-id').value; const payload = { days: parseInt(document.getElementById('plan-days').value), price: parseFloat(document.getElementById('plan-price').value) }; try { const res = await fetch(id ? `/api/admin/subscriptions/plans/${id}` : '/api/admin/subscriptions/plans', { method: id ? 'PUT' : 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }); if (!res.ok) throw new Error('Failed to save plan'); closePlanModal(); fetchPlans(); } catch (err) { console.error(err); showToast('Failed to save plan.', 'error', 'Save Failed'); } } async function deletePlan(id) { if (!confirm('Delete this plan?')) return; try { const res = await fetch(`/api/admin/subscriptions/plans/${id}`, { method: 'DELETE' }); if (!res.ok) throw new Error('Failed'); fetchPlans(); } catch (err) { console.error(err); showToast('Failed to delete plan.', 'error', 'Delete Failed'); } }
```

--------------------------------

### Catalog List Rendering

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/custom_catalogs.html

Renders the list of available catalogs and manages the expand/collapse UI logic.

```javascript
function renderCatalogs() { const box = document.getElementById('catalog-list'); const expandBtn = document.getElementById('catalog-expand-btn'); const wrapper = document.getElementById('catalog-list-wrapper'); if (!catalogs.length) { box.innerHTML = emptyState('✨', 'No custom catalog yet', 'Create your first curated Stremio section above.'); if (expandBtn) expandBtn.classList.add('hidden'); if (wrapper) wrapper.classList.remove('collapsed'); return; } box.innerHTML = catalogs.map(c => { const isActive = c._id === selectedCatalogId; const count = (c.items || []).length; const mode = c.visibility || 'public'; const meta = VIS_META[mode] || VIS_META.public; return `<div class="catalog-card p-4 ${isActive ? 'active' : ''}"> <button class="text-left w-full min-w-0" onclick="selectCatalog('${c._id}')"> <div class="flex items-center gap-2 min-w-0"> <span class="text-xl">${c.auto ? '✨' : meta.icon}</span> <h3 class="font-black truncate">${escapeHtml(c.name)}</h3> ${c.auto ? '<span class="pill text-[0.62rem] px-2 py-0.5">Auto</span>' : ''} </div> <div class="flex items-center gap-2 mt-2 flex-wrap"> <span class="vis-chip ${meta.chip}">${meta.icon} ${escapeHtml(visibilityLabel(mode))}</span> ${c.exclusive ? `<span class="vis-chip vis-owner">🔒 Exclusive${c.searchable ? ' · 🔎' : ''}</span>` : ''} <span class="muted text-xs">${count} title${count === 1 ? '' : 's'}</span> </div> </button> </div>`; }).join(''); // Manage expand button: only needed when list might overflow (~3+ cards) if (catalogs.length > 3) { if (expandBtn) { expandBtn.classList.remove('hidden'); expandBtn.textContent = catalogListExpanded ? '▴ Collapse list' : '▾ Show all catalogs'; } if (wrapper) wrapper.classList.toggle('collapsed', !catalogListExpanded); } else { if (expandBtn) expandBtn.classList.add('hidden'); if (wrapper) wrapper.classList.remove('collapsed'); } }
```

--------------------------------

### Copy Stream Link and Token Management

Source: https://github.com/weebzone/telegram-stremio/blob/master/Backend/fastapi/templates/media_edit.html

Utilities for generating and copying stream links to the clipboard and retrieving API tokens from various storage locations.

```javascript
function copyStreamLink(qualityId, fileName) { const base = window.location.origin; const token = getCopylinkToken(); if (!token) { showErrorMessage('No API token found. Please create an API token on the Dashboard page first.'); return; } const encodedName = encodeURIComponent(fileName || 'stream'); const url = `${base}/dl/${token}/${qualityId}/${encodedName}`; navigator.clipboard.writeText(url).then(() => { showSuccessMessage('Stream link copied to clipboard!'); }).catch(() => { prompt('Copy this stream link:', url); }); }
```

```javascript
function getCopylinkToken() { const serverToken = {{ (api_token | tojson) if api_token else 'null' }}; return serverToken || sessionStorage.getItem('api_token') || localStorage.getItem('api_token') || null; }
```
Tokens:
Raw