coursewatcher 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# CourseWatcher
+
+[![npm version](https://img.shields.io/npm/v/coursewatcher.svg)](https://www.npmjs.com/package/coursewatcher)
+[![npm downloads](https://img.shields.io/npm/dm/coursewatcher.svg)](https://www.npmjs.com/package/coursewatcher)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+
+**A CLI tool and web interface for tracking progress in downloaded video courses.**
+
+## Quick Start
+
+```bash
+# Navigate to your course folder
+cd /path/to/my-course
+
+# Run CourseWatcher
+npx coursewatcher
+
+# Or with options
+npx coursewatcher --port 8080 --no-browser
+```
+
+## Installation
+
+```bash
+npm install -g coursewatcher
+```
+
+## Features
+
+- 📺 **Video Tracking** — Automatically tracks watch status and playback position
+- 📁 **Module Grouping** — Groups videos by folder structure
+- 🎮 **Smart Player** — Keyboard shortcuts for speed/seek control
+- 🔍 **Video Search** — Find videos by name
+- 📝 **Notes** — Markdown notes for each video
+- 💾 **Portable Data** — Progress stored in `.coursewatcher` folder next to videos
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Space` | Play/Pause |
+| `W` | Decrease speed |
+| `E` | Increase speed |
+| `J` | Seek back 5s |
+| `K` | Seek forward 5s |
+| `L` | Seek forward 10s |
+| `Shift+J` | Seek back 30s |
+| `Shift+L` | Seek forward 30s |
+| `M` | Mute/Unmute |
+| `F` | Fullscreen |
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development
+npm run dev
+
+# Run tests
+npm test
+```
+
+## License
+
+MIT

package/bin/coursewatcher.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+/**
+ * CourseWatcher CLI Entry Point
+ * 
+ * Main executable for the coursewatcher command.
+ * Parses arguments and starts the web server.
+ * 
+ * @module bin/coursewatcher
+ */
+
+const { program } = require('commander');
+const path = require('path');
+const { version, description } = require('../package.json');
+const { startServer } = require('../src/server');
+const { log, success, error } = require('../src/utils/logger');
+
+program
+    .name('coursewatcher')
+    .description(description)
+    .version(version)
+    .argument('[path]', 'path to course directory', '.')
+    .option('-p, --port <number>', 'server port', '3000')
+    .option('--no-browser', 'do not open browser automatically')
+    .action(async (coursePath, options) => {
+        try {
+            const absolutePath = path.resolve(coursePath);
+            const port = parseInt(options.port, 10);
+
+            log(`Starting CourseWatcher in: ${absolutePath}`);
+
+            await startServer({
+                coursePath: absolutePath,
+                port,
+                openBrowser: options.browser,
+            });
+        } catch (err) {
+            error(`Failed to start CourseWatcher: ${err.message}`);
+            process.exit(1);
+        }
+    });
+
+program.parse();

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "coursewatcher",
+    "version": "1.0.0",
+    "description": "A CLI tool and web interface for tracking progress in downloaded video courses",
+    "main": "src/server.js",
+    "bin": {
+        "coursewatcher": "./bin/coursewatcher.js"
+    },
+    "scripts": {
+        "start": "node bin/coursewatcher.js",
+        "dev": "node bin/coursewatcher.js",
+        "test": "jest",
+        "test:coverage": "jest --coverage",
+        "test:watch": "jest --watch"
+    },
+    "keywords": [
+        "video",
+        "course",
+        "tracker",
+        "education",
+        "cli",
+        "progress",
+        "learning",
+        "tutorial"
+    ],
+    "author": "Serhii Shtokal <serhiishtokal@gmail.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/serhiishtokal/CourseWatcher.git"
+    },
+    "homepage": "https://github.com/serhiishtokal/CourseWatcher#readme",
+    "bugs": {
+        "url": "https://github.com/serhiishtokal/CourseWatcher/issues"
+    },
+    "files": [
+        "bin/",
+        "src/",
+        "views/",
+        "public/"
+    ],
+    "dependencies": {
+        "better-sqlite3": "^11.6.0",
+        "chalk": "^4.1.2",
+        "commander": "^12.1.0",
+        "ejs": "^3.1.10",
+        "express": "^4.21.1",
+        "open": "^8.4.2"
+    },
+    "devDependencies": {
+        "jest": "^29.7.0",
+        "supertest": "^7.0.0"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}