rmsitzandClaude Sonnet 5 5fe3fafc7a Add Outline integration: push lesson notes to a topic collection
Pick a topic on a lesson's note and it pushes to that topic's collection
in a self-hosted Outline instance when you leave the page; notes without a
topic stay local-only. Settings gets a new Outline Integration card
(URL/token, Save, Test Connection).

Credential handling: the API token lives in its own outline_config.json
in DATA_DIR, deliberately kept out of the general settings flow (GET
/api/settings is fetched on every page load by theme.js - no place for a
secret to ride along). GET /api/outline/config only ever returns whether
it's configured, never the token itself.

The topic chooser reflects Outline's live collection list rather than a
locally cached copy, and resolves a newly-typed topic name to a real
collection immediately (find-by-name-or-create) rather than waiting until
the note is pushed. That's not just an optimization: the push itself fires
via navigator.sendBeacon() on pagehide, which can't read a response, so a
page that fires pagehide more than once for the same load (a back/forward-
cache restore, for instance) would otherwise re-send the same "create a
new topic" intent every time and spawn duplicate collections. Verified
live against a local mock Outline server that firing pagehide repeatedly
for the same lesson creates the collection/document once and updates
thereafter.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-22 12:12:50 -04:00
2026-08-20 13:47:51 -04:00
2026-08-20 13:47:51 -04:00
2026-08-20 13:47:51 -04:00
2026-08-20 13:47:51 -04:00
2026-08-20 13:47:51 -04:00
2026-08-20 13:47:51 -04:00

OfflineU: Self-Hosted Local Course Loader & Progress Tracker

OfflineU is a sleek, self-hosted web app designed to load and view your offline video, audio, text, and quiz-based training courses. Whether it's Udemy downloads, "open sourced" training archives, or personal content, OfflineU turns your course folder into a fully navigable dashboard with automatic progress tracking.


Features

  • 📁 Dynamic folder parsing: Scans and maps your course structure into a browsable tree view.
  • 🎥 Video & Audio player: Integrated media player with resume & completion tracking.
  • 📄 Text & HTML viewer: Supports .txt, .md, .html, .pdf, and more.
  • Lesson progress tracking: Auto-saves your time spent and marks lessons as completed.
  • ♻️ Continue where you left off: Resume instantly from your last-accessed lesson.
  • 💾 Local-first & private: 100% offline. No cloud, no tracking, no nonsense.
  • 🧑‍💻 Works with any course format: No metadata required, just structured folders.
  • 🧠 Ideal for hoarders, students, or offline learning setups

🗈️ Screenshots

image


🛠️ Installation

🔁 Quick Start (Local)

  1. Clone the repo:

    git clone https://github.com/WhiskeyCoder/OfflineU.git
    cd OfflineU
    
  2. Install Python dependencies:

    pip install flask
    
  3. Run the app:

    python offlineu_core.py --create-templates
    
  4. Open your browser:

    http://127.0.0.1:5000
    

📂 Folder Structure Example

MyCourse/
├── Section 1/
│   ├── 01 - Intro.mp4
│   ├── 02 - Setup Guide.pdf
│   └── 03 - Quiz.html
├── Section 2/
│   ├── 04 - Advanced Tips.mp4
│   └── resources/
│       └── extras.md
└── .offlineu_progress.json  ← created automatically

🌟 File types are detected automatically — videos, audio, quizzes, and docs.


📁 Supported File Types

Type Extensions
Videos .mp4, .mkv, .webm, .mov, .avi, etc.
Audio .mp3, .wav, .aac, etc.
Docs .txt, .md, .html, .pdf, .docx
Subtitles .srt, .vtt
Quizzes Detected if file name contains quiz, exam, test, etc.

⚙️ CLI Options

Option Description
--host Set host (default: 127.0.0.1)
--port Set port (default: 5000)
--debug Enable Flask debug mode
--create-templates Generate default HTML templates
<course_path> Load course directly at startup

🧠 Roadmap

  • Base function and testing
  • Multi-user profile support
  • Dark/light theme switcher
  • Built-in quiz interactivity
  • Import/export course metadata
  • Mobile app wrapper
  • Self hosted Docker Deployment

💬 Community

Join the development, suggest features, or ask questions via:


🛡️ License

MIT License — Use freely, modify locally, share widely.


Author

Built with ❤️ by @WhiskeyCoder Inspired by the dream of learning freely, offline, and without limits.

S
Description
My version of offlineu
Readme MIT
1.1 MiB
Languages
HTML 58.2%
Python 41.4%
JavaScript 0.2%
Dockerfile 0.2%