@anandaramr/obscura 1.0.0

package/README.md

@@ -0,0 +1,3 @@
+# Obscura Media Server
+
+Core documentation and CLI guides will be published with the upcoming stable release.

package/dist/defaults.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_PORT = 4963;
+export declare const DEFAULT_ADDRESS = "0.0.0.0";
+export declare const DEFAULT_DIRECTORY = "./";
+export declare const DEFAULT_THUMB_THRESHOLD: number;
+export declare const DEFAULT_THUMB_SIZE = 400;
+export declare const DEFAULT_THUMB_LIMIT = 3;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,OAAO,CAAA;AAChC,eAAO,MAAM,eAAe,YAAY,CAAA;AACxC,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAErC,eAAO,MAAM,uBAAuB,QAAc,CAAA;AAClD,eAAO,MAAM,kBAAkB,MAAM,CAAA;AACrC,eAAO,MAAM,mBAAmB,IAAI,CAAA"}

package/dist/defaults.js

@@ -0,0 +1,7 @@
+export const DEFAULT_PORT = 4963;
+export const DEFAULT_ADDRESS = '0.0.0.0';
+export const DEFAULT_DIRECTORY = './';
+export const DEFAULT_THUMB_THRESHOLD = 1024 * 1024;
+export const DEFAULT_THUMB_SIZE = 400;
+export const DEFAULT_THUMB_LIMIT = 3;
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAA;AAChC,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAA;AACxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAA;AAErC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAAA;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAA"}

package/dist/file.d.ts

@@ -0,0 +1,5 @@
+import type { Result, FileMetaData } from "./types.js";
+export declare function validateDirectory(absoluteDirPath: string): Result<void, string>;
+export declare function parseFileMetadata(filePath: string): Promise<FileMetaData | null>;
+export declare function generateHash(fullPath: string): string;
+//# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAkCtD,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAc/E;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqBtF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,UAE5C"}

package/dist/file.js

@@ -0,0 +1,76 @@
+import path from "path";
+import fs from "fs";
+import crypto from "crypto";
+import sharp from "sharp";
+const IMAGE_EXTS = [
+    ".jpg",
+    ".jpeg",
+    ".png",
+    ".gif",
+    ".webp",
+    ".heic",
+    ".heif",
+    ".tiff",
+    ".tif",
+    ".avif",
+];
+const VIDEO_EXTS = [
+    ".mp4",
+    ".mov",
+    ".mkv",
+    ".webm",
+    ".m4v",
+    ".ts",
+    ".mts",
+    ".m2ts",
+];
+const ALWAYS_ANIMATED_EXTS = new Set([".gif"]);
+const SOMETIMES_ANIMATED = new Set([".webp", ".avif", ".png"]);
+export function validateDirectory(absoluteDirPath) {
+    if (!path.isAbsolute(absoluteDirPath)) {
+        return { error: `Directory validation failed: not an absolute path` };
+    }
+    if (!fs.existsSync(absoluteDirPath)) {
+        return { error: `Directory validation failed: directory not found` };
+    }
+    const stats = fs.statSync(absoluteDirPath);
+    if (!stats.isDirectory()) {
+        return { error: `Directory validation failed: not a directory` };
+    }
+    return {};
+}
+export async function parseFileMetadata(filePath) {
+    const basename = path.basename(filePath);
+    const ext = path.extname(basename).toLowerCase();
+    if (![...IMAGE_EXTS, ...VIDEO_EXTS].includes(ext))
+        return null;
+    const stat = fs.statSync(filePath);
+    let animated = false;
+    if (ALWAYS_ANIMATED_EXTS.has(ext))
+        animated = true;
+    else if (SOMETIMES_ANIMATED.has(ext))
+        animated = await isAnimated(filePath);
+    return {
+        id: generateHash(filePath),
+        name: basename,
+        path: filePath,
+        type: IMAGE_EXTS.includes(ext) ? "image" : "video",
+        date: stat.mtime,
+        size: stat.size,
+        ext: ext,
+        isAnimated: animated,
+    };
+}
+export function generateHash(fullPath) {
+    return crypto.createHash("md5").update(fullPath).digest("hex");
+}
+async function isAnimated(filePath) {
+    try {
+        const metadata = await sharp(filePath).metadata();
+        return (metadata.pages ?? 1) > 1;
+    }
+    catch (_) {
+        return false;
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,3 @@
+declare const _default: () => (req: import("node:http").IncomingMessage, res: import("node:http").ServerResponse<import("node:http").IncomingMessage>, callback: (err?: Error) => void) => void;
+export default _default;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"qKAWkB,CAAC;AA2CnB,wBACwG"}

package/dist/logger.js

@@ -0,0 +1,49 @@
+import morgan from "morgan";
+const colors = {
+    reset: "\x1b[0m",
+    green: "\x1b[32m",
+    cyan: "\x1b[36m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+    gray: "\x1b[90m",
+};
+morgan.token("colored-method", (req) => {
+    const method = req.method;
+    const color = method ? {
+        GET: colors.green,
+        POST: colors.cyan,
+        PUT: colors.yellow,
+        PATCH: colors.yellow,
+        DELETE: colors.red,
+    }[method] : colors.reset;
+    return `${color}${method}${colors.reset}`;
+});
+morgan.token("colored-status", (_, res) => {
+    const status = res.statusCode;
+    const color = status >= 500 ? colors.red : status >= 400 ? colors.yellow : status >= 300 ? colors.cyan : colors.green;
+    return `${color}${status}${colors.reset}`;
+});
+morgan.token("client-ip", (req) => {
+    return `${colors.gray}${req.headers["x-forwarded-for"] || req.socket.remoteAddress}${colors.reset}`;
+});
+morgan.token("device", (req) => {
+    const ua = req.headers["user-agent"];
+    if (!ua)
+        return "Unknown";
+    const name = ua.includes("Android")
+        ? "Android"
+        : ua.includes("iPhone")
+            ? "iPhone"
+            : ua.includes("iPad")
+                ? "iPad"
+                : ua.includes("Windows")
+                    ? "Windows"
+                    : ua.includes("Macintosh")
+                        ? "Mac"
+                        : ua.includes("Linux")
+                            ? "Linux"
+                            : "Unknown";
+    return name;
+});
+export default () => morgan(":date[iso] - :colored-method :url :colored-status :response-time ms — :client-ip [:device]");
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,MAAM,MAAM,GAAG;IACX,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,UAAU;IAClB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,UAAU;CACnB,CAAA;AAED,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,EAAE;IACnC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC,KAAK;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,MAAM;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,MAAM,EAAE,MAAM,CAAC,GAAG;KAClB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;IACrB,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;AAC7C,CAAC,CAAC,CAAA;AAEF,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;IACtC,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAA;IAC7B,MAAM,KAAK,GACP,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;IAC3G,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;AAC7C,CAAC,CAAC,CAAA;AAEF,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;IAC9B,OAAO,GAAG,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;AACvG,CAAC,CAAC,CAAA;AAEF,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;IAC3B,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACpC,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAA;IAEzB,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACrB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACnB,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;oBACtB,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;wBACxB,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;4BACpB,CAAC,CAAC,OAAO;4BACT,CAAC,CAAC,SAAS,CAAA;IACzB,OAAO,IAAI,CAAA;AACf,CAAC,CAAC,CAAA;AAEF,eAAe,GAAG,EAAE,CAChB,MAAM,CAAC,4FAA4F,CAAC,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import express from "express";
+import os from "os";
+import chokidar from "chokidar";
+import pLimit from "p-limit";
+import dotenv from "dotenv";
+dotenv.config({ quiet: true });
+import path from "path";
+import fs from "fs";
+import sharp from "sharp";
+sharp.cache(false);
+import { validateDirectory, parseFileMetadata, generateHash } from "./file.js";
+import { DEFAULT_PORT, DEFAULT_ADDRESS, DEFAULT_DIRECTORY, DEFAULT_THUMB_LIMIT, DEFAULT_THUMB_SIZE, DEFAULT_THUMB_THRESHOLD, } from "./defaults.js";
+import logger from "./logger.js";
+import { generateImageThumbnail, generateVideoThumbnail } from "./thumbnail.js";
+import { insertSorted } from "./utils.js";
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const PROJECT_ROOT = path.resolve(path.dirname(__filename), "..");
+const app = express();
+app.use(express.json());
+app.use(logger());
+app.use(express.static(path.join(PROJECT_ROOT, "public")));
+const GALLERY_DIR = path.resolve(process.cwd(), process.argv[2] || process.env.GALLERY_DIR || DEFAULT_DIRECTORY);
+const ADDRESS = process.argv[3] || process.env.ADDRESS || DEFAULT_ADDRESS;
+const PORT = parseInt(process.argv[4] || "") || parseInt(process.env.PORT || "") || DEFAULT_PORT;
+const THUMB_THRESHOLD = parseInt(process.env.THUMB_THRESHOLD || "") || DEFAULT_THUMB_THRESHOLD;
+const THUMB_SIZE = parseInt(process.env.THUMB_SIZE || "") || DEFAULT_THUMB_SIZE;
+const THUMB_LIMIT = parseInt(process.env.THUMB_LIMIT || "") || DEFAULT_THUMB_LIMIT;
+const THUMBS_DIR = path.join(PROJECT_ROOT, "thumbs");
+if (!fs.existsSync(THUMBS_DIR))
+    fs.mkdirSync(THUMBS_DIR, { recursive: true });
+const limit = pLimit(THUMB_LIMIT);
+const { error } = validateDirectory(GALLERY_DIR);
+if (error) {
+    console.error(`\x1b[31m[Obscura Startup Error]\x1b[0m ${error}`);
+    console.error(`Please provide a valid media directory path.`);
+    process.exit(1);
+}
+let filesMap = new Map();
+let sortedFiles = [];
+const watcher = chokidar.watch(GALLERY_DIR, {
+    ignored: /(^|[\/\\])\../,
+    persistent: true,
+    ignoreInitial: false,
+});
+let clients = [];
+let isBooting = true;
+function broadcastToUsers(action, fileData) {
+    clients.forEach((client) => {
+        client.res.write(`data: ${JSON.stringify({ action, file: fileData })}\n\n`);
+    });
+}
+watcher.on("add", async (filePath) => {
+    const fileData = await parseFileMetadata(filePath);
+    if (!fileData)
+        return;
+    const isExisting = filesMap.has(fileData.id);
+    filesMap.set(fileData.id, fileData);
+    if (isExisting)
+        return;
+    const { id, name, type, date, size, isAnimated } = fileData;
+    const clientFileData = { id, name, type, date, size, isAnimated };
+    insertSorted(sortedFiles, clientFileData, (file) => new Date(file.date).getTime(), (a, b) => b - a);
+    if (isBooting)
+        return;
+    broadcastToUsers("add", clientFileData);
+});
+watcher.on("unlink", (filePath) => {
+    const fileId = generateHash(filePath);
+    if (filesMap.has(fileId)) {
+        filesMap.delete(fileId);
+        sortedFiles = sortedFiles.filter((file) => file.id !== fileId);
+        broadcastToUsers("remove", { id: fileId });
+        const thumbPath = path.join(THUMBS_DIR, `${fileId}.jpg`);
+        fs.unlink(thumbPath, () => { });
+    }
+});
+watcher.on("ready", () => {
+    isBooting = false;
+});
+app.get("/api/files", (req, res) => {
+    res.status(200).json(sortedFiles);
+});
+app.get("/api/files/:id", (req, res) => {
+    const file = filesMap.get(req.params.id);
+    if (!file)
+        return res.sendStatus(404);
+    res.sendFile(file.path);
+});
+app.get("/api/events", (req, res) => {
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    const clientId = Date.now();
+    clients.push({ id: clientId, res });
+    req.on("close", () => {
+        clients = clients.filter((client) => client.id !== clientId);
+    });
+});
+app.get("/api/thumb/:id", async (req, res) => {
+    const file = filesMap.get(req.params.id);
+    if (!file)
+        return res.sendStatus(404);
+    if (shouldAvoidCaching(file)) {
+        return res.sendFile(file.path);
+    }
+    const thumbPath = path.join(THUMBS_DIR, `${file.id}.jpg`);
+    try {
+        await limit(async () => {
+            // check again after waiting in queue
+            if (fs.existsSync(thumbPath))
+                return;
+            if (file.type === "image") {
+                await generateImageThumbnail(file, thumbPath, THUMB_SIZE);
+            }
+            else {
+                await generateVideoThumbnail(file, thumbPath, THUMB_SIZE);
+            }
+        });
+        res.sendFile(path.resolve(thumbPath));
+    }
+    catch (err) {
+        console.error(`Error while creating thumbnail: ${err}`);
+        res.sendStatus(500);
+    }
+});
+app.listen(PORT, ADDRESS, (error) => {
+    if (error) {
+        console.error(`\x1b[31m[Obscura Startup Error]\x1b[0m ${error.message}`);
+        process.exit(1);
+    }
+    console.log(`Obscura running at ${ADDRESS}:${PORT}`);
+    console.log(`Serving media from \x1b[36m${GALLERY_DIR}\x1b[0m\n`);
+    const interfaces = os.networkInterfaces();
+    Object.entries(interfaces).forEach(([name, addresses]) => {
+        addresses
+            ?.filter((addr) => addr.family === "IPv4")
+            .forEach((addr) => {
+            console.log(`- \x1b[36mhttp://${addr.address}:${PORT}\x1b[0m \t [${name}]`);
+        });
+    });
+    console.log("\n");
+});
+function shouldAvoidCaching(file) {
+    return file.type == "image" && (file.size < THUMB_THRESHOLD && !file.isAnimated);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/thumbnail.d.ts

@@ -0,0 +1,4 @@
+import type { FileMetaData } from "./types.js";
+export declare function generateVideoThumbnail(file: FileMetaData, thumbPath: string, thumbSize: number): Promise<void>;
+export declare function generateImageThumbnail(file: FileMetaData, thumbPath: string, thumbSize: number): Promise<void>;
+//# sourceMappingURL=thumbnail.d.ts.map

package/dist/thumbnail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail.d.ts","sourceRoot":"","sources":["../src/thumbnail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAQ9C,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAuB9F;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAKpG"}

package/dist/thumbnail.js

@@ -0,0 +1,31 @@
+import { execFile } from "child_process";
+import sharp from "sharp";
+import ffmpeg from "ffmpeg-static";
+const ffmpegPath = typeof ffmpeg === "string" ? ffmpeg : ffmpeg.default;
+export function generateVideoThumbnail(file, thumbPath, thumbSize) {
+    return new Promise((resolve, reject) => {
+        execFile(ffmpegPath, [
+            "-i",
+            file.path,
+            "-frames:v",
+            "1",
+            "-vf",
+            `scale=${thumbSize}:${thumbSize}:force_original_aspect_ratio=increase,crop=${thumbSize}:${thumbSize}:(iw-${thumbSize})/2:(ih-${thumbSize})/2`,
+            "-q:v",
+            "2",
+            thumbPath,
+        ], (err, _stdout, _stderr) => {
+            if (err) {
+                return reject(new Error(`ffmpeg error: ${err.message}`));
+            }
+            resolve();
+        });
+    });
+}
+export async function generateImageThumbnail(file, thumbPath, thumbSize) {
+    await sharp(file.path, { animated: false, page: 0 })
+        .resize(thumbSize, thumbSize, { fit: "cover" })
+        .jpeg({ quality: 80 })
+        .toFile(thumbPath);
+}
+//# sourceMappingURL=thumbnail.js.map

package/dist/thumbnail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail.js","sourceRoot":"","sources":["../src/thumbnail.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,MAAM,MAAM,eAAe,CAAA;AAElC,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAAc,CAAC,OAAO,CAAA;AAEhF,MAAM,UAAU,sBAAsB,CAAC,IAAkB,EAAE,SAAiB,EAAE,SAAiB;IAC3F,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzC,QAAQ,CACJ,UAAU,EACV;YACI,IAAI;YACJ,IAAI,CAAC,IAAI;YACT,WAAW;YACX,GAAG;YACH,KAAK;YACL,SAAS,SAAS,IAAI,SAAS,8CAA8C,SAAS,IAAI,SAAS,QAAQ,SAAS,WAAW,SAAS,KAAK;YAC7I,MAAM;YACN,GAAG;YACH,SAAS;SACZ,EACD,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACtB,IAAI,GAAG,EAAE,CAAC;gBACN,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;YAC5D,CAAC;YACD,OAAO,EAAE,CAAA;QACb,CAAC,CACJ,CAAA;IACL,CAAC,CAAC,CAAA;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAkB,EAAE,SAAiB,EAAE,SAAiB;IACjG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SAC/C,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;SAC9C,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;SACrB,MAAM,CAAC,SAAS,CAAC,CAAA;AAC1B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+import type { Response } from "express";
+export interface FileMetaData {
+    id: string;
+    name: string;
+    path: string;
+    type: "image" | "video";
+    date: Date;
+    size: number;
+    ext: string;
+    isAnimated: boolean;
+}
+export type ClientFileMetadata = Pick<FileMetaData, "id" | "name" | "type" | "date" | "size" | "isAnimated">;
+export interface SseClient {
+    id: number;
+    res: Response;
+}
+export interface Result<T, S> {
+    result?: T;
+    error?: S;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC,CAAA;AAE5G,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,QAAQ,CAAA;CAChB;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,KAAK,CAAC,EAAE,CAAC,CAAA;CACZ"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function insertSorted<T>(arr: T[], element: T, key: (element: T) => number, comparator?: (a: number, b: number) => number): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,EAC1B,GAAG,EAAE,CAAC,EAAE,EACR,OAAO,EAAE,CAAC,EACV,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,EAC3B,UAAU,IAAI,GAAG,MAAM,EAAE,GAAG,MAAM,WAAU,QAkB/C"}

package/dist/utils.js

@@ -0,0 +1,17 @@
+export function insertSorted(arr, element, key, comparator = (a, b) => a - b) {
+    let low = 0;
+    let high = arr.length;
+    const targetValue = key(element);
+    while (low < high) {
+        const mid = (low + high) >>> 1;
+        const midValue = key(arr[mid]);
+        if (comparator(targetValue, midValue) > 0) {
+            low = mid + 1;
+        }
+        else {
+            high = mid;
+        }
+    }
+    arr.splice(low, 0, element);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CACxB,GAAQ,EACR,OAAU,EACV,GAA2B,EAC3B,aAAa,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;IAE5C,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAA;IACrB,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,CAAA;IAEhC,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC,CAAA;QAEnC,IAAI,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAA;QACjB,CAAC;aAAM,CAAC;YACJ,IAAI,GAAG,GAAG,CAAA;QACd,CAAC;IACL,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;AAC/B,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@anandaramr/obscura",
+  "version": "1.0.0",
+  "description": "A lightweight local media streaming server",
+  "main": "dist/server.js",
+  "type": "module",
+  "bin": {
+    "obscura": "dist/server.js"
+  },
+  "files": [
+    "dist/**/*",
+    "public/**/*"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chokidar": "^5.0.0",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1",
+    "ffmpeg-static": "^5.3.0",
+    "morgan": "^1.10.1",
+    "p-limit": "^7.3.0",
+    "sharp": "^0.34.5"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/morgan": "^1.9.10",
+    "@types/node": "^25.9.1",
+    "@types/sharp": "^0.31.1",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3"
+  }
+}

package/public/app.js

@@ -0,0 +1,288 @@
+let files = []
+let isShuffled = false
+let elementMap = new Map()
+
+function onVideoPlay(fileId) {
+    clearTimeout(cacheTTLMap.get(fileId))
+    cacheTTLMap.delete(fileId)
+}
+
+function onVideoPause(fileId, vid) {
+    const timer = setTimeout(() => {
+        vid.removeAttribute('src')
+        vid.load()
+        cacheTTLMap.delete(fileId)
+    }, VIDEO_CACHE_TTL)
+
+    cacheTTLMap.set(fileId, timer)
+}
+
+init()
+
+async function init() {
+    const res = await fetch('/api/files')
+    files = await res.json()
+
+    params = new URLSearchParams(window.location.search)
+    isShuffled = params.has('shuffle')
+    const fileList = isShuffled ? shuffleArray(files) : files
+
+    renderGrids(fileList)
+    updateShuffledState(isShuffled)
+}
+
+function renderGrids(files) {
+    const grid = document.getElementById('grid')
+
+    for (let i = 0; i < files.length; i++) {
+        const file = files[i]
+        insertGridItem(file, grid)
+    }
+}
+
+const eventSource = new EventSource('/api/events')
+
+eventSource.onmessage = evt => {
+    const data = JSON.parse(evt.data)
+    const grid = document.getElementById('grid')
+
+    if (data.action === 'add') {
+        insertGridItem(data.file, grid, true)
+    } else if (data.action === 'remove') {
+        removeGridItem(data.file.id)
+    }
+}
+
+let previewWindow = []
+const observer = new IntersectionObserver(
+    entries => {
+        entries.forEach(entry => {
+            if (entry.isIntersecting) {
+                onVisible(entry.target)
+            } else {
+                if (previewWindow.includes(entry.target)) {
+                    onEndOfVisibility(entry.target)
+                }
+            }
+        })
+    },
+    { threshold: 1 }
+)
+
+let currentPreview = null
+function onVisible(preview) {
+    const vid = preview.getElementsByClassName('video-preview')[0]
+    previewWindow.push(preview)
+    previewWindow.sort((a, b) => a.getBoundingClientRect().top - b.getBoundingClientRect().top)
+
+    vid.onended = evt => {
+        const idx = previewWindow.indexOf(preview)
+        stopMobilePreview(idx)
+        startMobilePreview((idx + 1) % previewWindow.length)
+    }
+
+    if (!currentPreview) startMobilePreview(0)
+}
+
+function onEndOfVisibility(preview) {
+    const idx = previewWindow.indexOf(preview)
+    const isCurrentlyPlaying = currentPreview == preview
+
+    stopMobilePreview(idx)
+    previewWindow.splice(idx, 1)
+    if (isCurrentlyPlaying && previewWindow.length) startMobilePreview(idx % previewWindow.length)
+}
+
+function insertGridItem(file, grid, prepend = false) {
+    const preview = document.createElement('a')
+
+    preview.className = 'grid-item'
+    preview.href = `/api/files/${file.id}`
+    preview.id = file.id
+
+    const media = document.createElement('img')
+    media.src = `/api/thumb/${file.id}`
+    media.loading = 'lazy'
+    media.className = file.type === 'image' ? 'img' : 'video'
+    preview.appendChild(media)
+
+    if (file.type != 'image') {
+        const icon = document.createElement('span')
+        icon.className = 'play-icon'
+
+        const iconImg = document.createElement('img')
+        iconImg.src = '/play_icon.svg'
+
+        icon.appendChild(iconImg)
+        preview.appendChild(icon)
+
+        const vid = document.createElement('video')
+        vid.preload = 'none'
+        vid.classList.add('video-preview', 'fade')
+        vid.muted = true
+        vid.loop = !isMobileDevice()
+
+        preview.appendChild(vid)
+
+        preview.onmouseenter = () => {
+            if (!isMobileDevice()) {
+                startVideoPreview(vid, file.id, media, icon)
+            }
+        }
+
+        preview.onmouseleave = () => {
+            if (!isMobileDevice()) {
+                stopVideoPreview(vid, file.id, media, icon)
+            }
+        }
+    } else if (file.isAnimated) {
+        const icon = document.createElement('span')
+        icon.className = 'live-indicator'
+        icon.innerText = "LIVE"
+        preview.appendChild(icon)
+
+        preview.onmouseenter = () => {
+            if (!isMobileDevice()) {
+                media.src = `/api/files/${file.id}`
+            }
+        }
+        
+        preview.onmouseleave = () => {
+            if (!isMobileDevice()) {
+                media.src = `/api/thumb/${file.id}`
+            }
+        }
+    }
+
+    if (prepend) {
+        grid.prepend(preview)
+    } else {
+        grid.appendChild(preview)
+    }
+
+    if (isMobileDevice() && file.type === 'video') observer.observe(preview)
+    elementMap.set(file.id, preview)
+}
+
+const VIDEO_CACHE_TTL = 60 * 1000
+let cacheTTLMap = new Map()
+
+function stopMobilePreview(idx) {
+    const preview = previewWindow[idx]
+    if (currentPreview != preview) return
+
+    const vid = preview.getElementsByClassName('video-preview')[0]
+    const media = preview.getElementsByClassName('video')[0]
+    const icon = preview.getElementsByClassName('play-icon')[0]
+
+    stopVideoPreview(vid, preview.id, media, icon)
+    currentPreview = null
+}
+
+function startMobilePreview(idx) {
+    const preview = previewWindow[idx]
+    currentPreview = preview
+
+    const vid = preview.getElementsByClassName('video-preview')[0]
+    if (!vid) return
+
+    const media = preview.getElementsByTagName('img')[0]
+    const icon = preview.getElementsByTagName('span')[0]
+    startVideoPreview(vid, preview.id, media, icon)
+}
+
+function stopVideoPreview(vid, id, media, icon) {
+    vid.pause()
+    onVideoPause(id, vid)
+    
+    vid.classList.add('fade')
+    media.classList.remove('fade')
+    icon.classList.remove('blink')
+    icon.classList.remove('fade')
+}
+
+function startVideoPreview(vid, id, media, icon) {
+    icon.classList.add('blink')
+    vid.addEventListener(
+        'playing',
+        () => {
+            icon.classList.remove('blink')
+            icon.classList.add('fade')
+        },
+        { once: true }
+    )
+
+    if (!vid.src) {
+        vid.src = `/api/files/${id}`
+        vid.load()
+    }
+
+    vid.classList.remove('fade')
+    media.classList.add('fade')
+
+    vid.currentTime = 0
+    onVideoPlay(id)
+    vid.play().catch(err => console.log('Play interrupted:', err))
+}
+
+function isMobileDevice() {
+    return !window.matchMedia('(min-width: 769px)').matches
+}
+
+function removeGridItem(fileId) {
+    const child = elementMap.get(fileId)
+    if (child) {
+        const grid = document.getElementById('grid')
+        grid.removeChild(child)
+        elementMap.delete(fileId)
+        files = files.filter(f => f.id !== fileId)
+    }
+}
+
+function shuffleGrid() {
+    const shuffledIds = shuffleArray(files.map(f => f.id))
+    const grid = document.getElementById('grid')
+    grid.replaceChildren(...shuffledIds.map(id => elementMap.get(id)).filter(Boolean))
+
+    updateShuffledState(true)
+}
+
+function unShuffleGrid() {
+    const grid = document.getElementById('grid')
+    grid.replaceChildren(...files.map(f => elementMap.get(f.id)).filter(Boolean))
+    updateShuffledState(false)
+}
+
+function updateShuffledState(newState) {
+    isShuffled = newState
+    const button = document.getElementById('shuffle-btn')
+    const url = new URL(window.location)
+
+    if (newState) {
+        button.classList.add('active')
+        button.classList.remove('inactive')
+        url.searchParams.set('shuffle', '1')
+    } else {
+        button.classList.remove('active')
+        button.classList.add('inactive')
+        url.searchParams.delete('shuffle')
+    }
+    history.replaceState({ shuffle: newState }, '', url)
+}
+
+function toggleShuffle() {
+    if (isShuffled) {
+        unShuffleGrid()
+    } else {
+        shuffleGrid()
+    }
+}
+
+function shuffleArray(array) {
+    let copy = [...array]
+    for (let i = array.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1))
+        ;[copy[i], copy[j]] = [copy[j], copy[i]]
+    }
+    return copy
+}

package/public/index.html

@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<title>Obscura</title>
+	<link rel="stylesheet" href="style.css">
+</head>
+
+<body>
+	<div id="app">
+		<div class="grid" id="grid"></div>
+		<button id="shuffle-btn" onclick="toggleShuffle()">
+			<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" class="bi bi-shuffle"
+				viewBox="0 0 16 16">
+				<path fill-rule="evenodd"
+					d="M0 3.5A.5.5 0 0 1 .5 3H1c2.202 0 3.827 1.24 4.874 2.418.49.552.865 1.102 1.126 1.532.26-.43.636-.98 1.126-1.532C9.173 4.24 10.798 3 13 3v1c-1.798 0-3.173 1.01-4.126 2.082A9.6 9.6 0 0 0 7.556 8a9.6 9.6 0 0 0 1.317 1.918C9.828 10.99 11.204 12 13 12v1c-2.202 0-3.827-1.24-4.874-2.418A10.6 10.6 0 0 1 7 9.05c-.26.43-.636.98-1.126 1.532C4.827 11.76 3.202 13 1 13H.5a.5.5 0 0 1 0-1H1c1.798 0 3.173-1.01 4.126-2.082A9.6 9.6 0 0 0 6.444 8a9.6 9.6 0 0 0-1.317-1.918C4.172 5.01 2.796 4 1 4H.5a.5.5 0 0 1-.5-.5" />
+				<path
+					d="M13 5.466V1.534a.25.25 0 0 1 .41-.192l2.36 1.966c.12.1.12.284 0 .384l-2.36 1.966a.25.25 0 0 1-.41-.192m0 9v-3.932a.25.25 0 0 1 .41-.192l2.36 1.966c.12.1.12.284 0 .384l-2.36 1.966a.25.25 0 0 1-.41-.192" />
+			</svg>
+		</button>
+	</div>
+
+	<script src="app.js"></script>
+</body>
+
+</html>

package/public/play_icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#e3e3e3"><path d="M320-200v-560l440 280-440 280Zm80-280Zm0 134 210-134-210-134v268Z"/></svg>

package/public/style.css

@@ -0,0 +1,169 @@
+* {
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}
+
+body {
+    background: #000;
+    color: #fff;
+    font-family: Arial, sans-serif;
+}
+
+@media (prefers-color-scheme: light) {
+    body {
+        background-color: floralwhite;
+    }
+}
+
+.grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
+    gap: 15px;
+    padding: 20px;
+}
+
+.grid-item {
+    position: relative;
+    background-color: #000;
+    overflow: hidden;
+    border-radius: 12px;
+    transition:
+        transform 0.3s ease,
+        opacity 0.7s ease;
+    height: 300px;
+    -webkit-tap-highlight-color: transparent;
+    opacity: 1;
+}
+
+.img,
+.video {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+    object-position: center;
+    display: block;
+    position: absolute;
+    transition: transform 0.4s ease, opacity 0.2s ease-in;
+}
+
+.video {
+    filter: brightness(0.8);
+}
+
+.video-preview {
+    width: 100%;
+    height: 100%;
+    object-fit: contain;
+    position: absolute;
+    transition: opacity 0.2s ease-in;
+}
+
+.fade {
+    opacity: 0;
+}
+
+@media (hover: hover) and (pointer: fine) {
+    .grid-item:hover {
+        transform: scale(1.03);
+    }
+
+    .grid-item:hover .img{
+        transform: scale(1.08);
+    }
+}
+
+.play-icon {
+    color: white;
+    position: absolute;
+    right: 3%;
+    top: 3%;
+    font-size: x-large;
+    user-select: none;
+    pointer-events: none;
+    transition: transform none;
+    filter: drop-shadow(0 0 10px #000);
+}
+
+.play-icon img {
+    width: 42px;
+    height: auto;
+}
+
+.blink {
+    animation: pulse 1s ease-in-out infinite;
+    animation-delay: 0.2s;
+}
+
+@keyframes pulse {
+  0%, 100% {
+    opacity: 0.8;
+  }
+
+  50% {
+    opacity: 0.4;
+  }
+}
+
+.live-indicator {
+    color: white;
+    position: absolute;
+    right: 3%;
+    top: 3%;
+    font-size: medium;
+    font-weight: 700;
+    font-family: monospace;
+    text-shadow: #000 0 0 8px;
+    user-select: none;
+    pointer-events: none;
+    transition: transform 0.4s ease;
+    opacity: 0.8;
+}
+
+#shuffle-btn {
+    position: fixed;
+    bottom: 40px;
+    right: 40px;
+    width: 52px;
+    height: 52px;
+    border-radius: 50%;
+    border: none;
+
+    visibility: hidden;
+
+    font-size: 1.5rem;
+    backdrop-filter: blur(8px);
+    transition: all 0.5s ease;
+    background-color: transparent;
+
+    cursor: pointer;
+    user-select: none;
+    z-index: 10;
+
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    line-height: 1;
+
+    -webkit-tap-highlight-color: transparent;
+}
+
+#shuffle-btn.active {
+    visibility: visible;
+    background: rgba(255, 255, 255, 0.3);
+    color: #000;
+    box-shadow: rgba(255, 255, 255, 0.3) 0px 0px 15px 5px;
+}
+
+#shuffle-btn.inactive {
+    visibility: visible;
+    background: rgba(45, 43, 43, 0.15);
+    color: #fff;
+    box-shadow: rgba(45, 43, 43, 0.15) 0px 0px 15px 5px;
+}
+
+@starting-style {
+    .grid-item {
+        opacity: 0.2;
+    }
+}