Add Jellyfin CLI + update wind-down instructions with concrete suggestions
This commit is contained in:
Agent
parent
4be80803d4
commit
f1db2f3b2d
4 changed files with 185 additions and 0 deletions
150
bin/jellyfin
Executable file
150
bin/jellyfin
Executable file
|
|
@ -0,0 +1,150 @@
|
|||
#!/usr/bin/env node
|
||||
// Jellyfin CLI — token-efficient output for assistant use
|
||||
const https = require('https');
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
// Load credentials
|
||||
const envFile = fs.readFileSync(path.join(__dirname, '..', '.credentials', 'jellyfin.env'), 'utf8');
|
||||
const env = {};
|
||||
envFile.split('\n').forEach(l => { const [k, ...v] = l.split('='); if (k && v.length) env[k.trim()] = v.join('=').trim(); });
|
||||
|
||||
const BASE = env.JELLYFIN_URL;
|
||||
const API_KEY = env.JELLYFIN_API_KEY;
|
||||
const USER_ID = env.JELLYFIN_USER_ID;
|
||||
|
||||
function api(endpoint) {
|
||||
const sep = endpoint.includes('?') ? '&' : '?';
|
||||
const url = `${BASE}${endpoint}${sep}api_key=${API_KEY}`;
|
||||
return new Promise((resolve, reject) => {
|
||||
https.get(url, res => {
|
||||
let data = '';
|
||||
res.on('data', c => data += c);
|
||||
res.on('end', () => {
|
||||
try { resolve(JSON.parse(data)); } catch { resolve(data); }
|
||||
});
|
||||
}).on('error', reject);
|
||||
});
|
||||
}
|
||||
|
||||
function getUserId() { return USER_ID; }
|
||||
|
||||
function dur(ticks) {
|
||||
if (!ticks) return '';
|
||||
const min = Math.round(ticks / 600000000);
|
||||
if (min < 60) return `${min}m`;
|
||||
return `${Math.floor(min/60)}h${min%60 ? ' '+min%60+'m' : ''}`;
|
||||
}
|
||||
|
||||
function pct(userData, runTimeTicks) {
|
||||
if (!userData) return '';
|
||||
if (userData.Played) return '✓';
|
||||
if (userData.PlayedPercentage) return Math.round(userData.PlayedPercentage) + '%';
|
||||
if (userData.PlaybackPositionTicks && runTimeTicks) return Math.round(userData.PlaybackPositionTicks / runTimeTicks * 100) + '%';
|
||||
return '';
|
||||
}
|
||||
|
||||
const commands = {
|
||||
async resume(limit = 10) {
|
||||
const uid = await getUserId();
|
||||
const r = await api(`/Users/${uid}/Items/Resume?Limit=${limit}&Fields=Overview,RunTimeTicks&MediaTypes=Video`);
|
||||
if (!r.Items.length) return console.log('Nothing in progress');
|
||||
console.log('TITLE\tEPISODE\tPROGRESS\tDURATION');
|
||||
r.Items.forEach(i => {
|
||||
const show = i.SeriesName || '';
|
||||
const name = show ? `${i.Name}` : i.Name;
|
||||
console.log([show || i.Name, show ? i.Name : '', pct(i.UserData, i.RunTimeTicks), dur(i.RunTimeTicks)].join('\t'));
|
||||
});
|
||||
},
|
||||
|
||||
async recent(limit = 10) {
|
||||
const uid = await getUserId();
|
||||
const r = await api(`/Users/${uid}/Items/Latest?Limit=${limit}&Fields=RunTimeTicks`);
|
||||
if (!r.length) return console.log('No recent items');
|
||||
console.log('TYPE\tTITLE\tNAME\tYEAR\tDURATION');
|
||||
r.forEach(i => {
|
||||
console.log([i.Type === 'Episode' ? 'EP' : 'MOV', i.SeriesName || i.Name, i.SeriesName ? i.Name : '', i.ProductionYear || '', dur(i.RunTimeTicks)].join('\t'));
|
||||
});
|
||||
},
|
||||
|
||||
async watched(limit = 20) {
|
||||
const uid = await getUserId();
|
||||
const r = await api(`/Users/${uid}/Items?Limit=${limit}&SortBy=DatePlayed&SortOrder=Descending&Filters=IsPlayed&Recursive=true&IncludeItemTypes=Movie,Episode&Fields=RunTimeTicks,DateLastMediaAdded`);
|
||||
if (!r.Items.length) return console.log('No watched items');
|
||||
console.log('TYPE\tTITLE\tEPISODE\tYEAR');
|
||||
r.Items.forEach(i => {
|
||||
console.log([i.Type === 'Episode' ? 'EP' : 'MOV', i.SeriesName || i.Name, i.SeriesName ? i.Name : '', i.ProductionYear || ''].join('\t'));
|
||||
});
|
||||
},
|
||||
|
||||
async shows() {
|
||||
const uid = await getUserId();
|
||||
const r = await api(`/Users/${uid}/Items?IncludeItemTypes=Series&Recursive=true&SortBy=SortName&Fields=RunTimeTicks`);
|
||||
if (!r.Items.length) return console.log('No shows');
|
||||
console.log('TITLE\tYEAR\tSTATUS');
|
||||
r.Items.forEach(i => {
|
||||
console.log([i.Name, i.ProductionYear || '', pct(i.UserData, i.RunTimeTicks) || 'unwatched'].join('\t'));
|
||||
});
|
||||
},
|
||||
|
||||
async movies() {
|
||||
const uid = await getUserId();
|
||||
const r = await api(`/Users/${uid}/Items?IncludeItemTypes=Movie&Recursive=true&SortBy=SortName&Fields=RunTimeTicks`);
|
||||
if (!r.Items.length) return console.log('No movies');
|
||||
console.log('TITLE\tYEAR\tDURATION\tSTATUS');
|
||||
r.Items.forEach(i => {
|
||||
console.log([i.Name, i.ProductionYear || '', dur(i.RunTimeTicks), pct(i.UserData, i.RunTimeTicks) || '-'].join('\t'));
|
||||
});
|
||||
},
|
||||
|
||||
async search(query) {
|
||||
if (!query) { console.error('Usage: jellyfin search <query>'); process.exit(1); }
|
||||
const uid = await getUserId();
|
||||
const r = await api(`/Users/${uid}/Items?SearchTerm=${encodeURIComponent(query)}&Recursive=true&IncludeItemTypes=Movie,Series,Episode&Limit=10&Fields=RunTimeTicks`);
|
||||
if (!r.Items.length) return console.log('No results');
|
||||
console.log('TYPE\tTITLE\tNAME\tYEAR');
|
||||
r.Items.forEach(i => {
|
||||
console.log([i.Type, i.SeriesName || i.Name, i.SeriesName ? i.Name : '', i.ProductionYear || ''].join('\t'));
|
||||
});
|
||||
},
|
||||
|
||||
async stats() {
|
||||
const uid = await getUserId();
|
||||
const [movies, shows, episodes] = await Promise.all([
|
||||
api(`/Users/${uid}/Items?IncludeItemTypes=Movie&Recursive=true&Filters=IsPlayed`),
|
||||
api(`/Users/${uid}/Items?IncludeItemTypes=Series&Recursive=true`),
|
||||
api(`/Users/${uid}/Items?IncludeItemTypes=Episode&Recursive=true&Filters=IsPlayed`),
|
||||
]);
|
||||
console.log(`Movies watched:\t${movies.TotalRecordCount}`);
|
||||
console.log(`Shows in library:\t${shows.TotalRecordCount}`);
|
||||
console.log(`Episodes watched:\t${episodes.TotalRecordCount}`);
|
||||
},
|
||||
|
||||
async libraries() {
|
||||
const uid = getUserId();
|
||||
const r = await api(`/Users/${uid}/Views`);
|
||||
console.log('NAME\tTYPE\tID');
|
||||
(r.Items || []).forEach(l => {
|
||||
console.log([l.Name, l.CollectionType || 'mixed', l.Id].join('\t'));
|
||||
});
|
||||
}
|
||||
};
|
||||
|
||||
const cmd = process.argv[2];
|
||||
const args = process.argv.slice(3);
|
||||
|
||||
if (!cmd || !commands[cmd]) {
|
||||
console.log('Usage: jellyfin <command> [args]\n');
|
||||
console.log('Commands:');
|
||||
console.log(' resume [limit] Continue watching');
|
||||
console.log(' recent [limit] Recently added');
|
||||
console.log(' watched [limit] Watch history');
|
||||
console.log(' shows All series');
|
||||
console.log(' movies All movies');
|
||||
console.log(' search <query> Search library');
|
||||
console.log(' stats Watch statistics');
|
||||
console.log(' libraries List libraries');
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
commands[cmd](...args).catch(e => { console.error(e.message); process.exit(1); });
|
||||
Loading…
Add table
Add a link
Reference in a new issue