TubeNotes - Visual Video Knowledge Base

Video Library

Canvas Mode - Visual Note Taking

Kanban Task Mode

---

Türkçe | English | Deutsch | Español

---

TR: Bu proje hem hobi hem ihtiyaç olarak AI ile geliştirilmektedir. Geliştirmeler devam edecektir. Uygulamayı hemen kullanmak için Hızlı Başlangıç kısmına ilerleyin. Planlanan özellikleri ve proje yönlendirmesi ROADMAP.md. dosyası içindedir. Geliştirme sürecinin güncel ilerleyişini GitHub Projeler panosu ve CHANGELOG.md üzerinden takip edebilirsiniz. Katkı yapmak için CONTRIBUTING.md dosyasından yönergelere ulaşabilirsiniz.

EN: This project is being developed with AI as both a hobby and a necessity. Development will continue. Go to Quick Start to start using the app right away. Planned features and project direction can be found in ROADMAP.md. Current development progress can be tracked via the GitHub Projects board and CHANGELOG.md. For contribution guidelines, refer to CONTRIBUTING.md.

---

Türkçe

TubeNotes, YouTube videolarınız için modern bir görsel bilgi yönetim sistemidir. Video notları alın, sonsuz canvas üzerinde fikirlerinizi görselleştirin, şekiller çizin, markdown notları ekleyin, Kanban görevlerinizi yönetin. Masaüstü uygulaması (Windows, macOS, Linux) olarak kullanılabilir.

Hızlı Başlangıç

• Adım 1: Yayınlar sayfasına gidin.
• Adım 2: En son sürümü indirin.
• Adım 3: Yükleyin ve not almaya başlayın!

Ana Özellikler

• Kanban Görevler Modu
• Kanvas Not Alanı
• YouTube Video Notları
• Organizasyon Sistemi
• Tema Desteği
• Arama ve Filtreleme
• Yerel Depolama

Teknolojiler

Kategori	Teknoloji
Framework	Next.js 16.1.6 (App Router, Turbopack)
Masaüstü	Electron 40.0.0 + electron-builder
Veritabanı	SQLite (better-sqlite3 12.6.2)
ORM	Prisma 6.19.2 (schema tanımı için)
Dil	TypeScript 5
Stil	Tailwind CSS 4
Canvas	@xyflow/react 12.10.0 (React Flow)
Editör (Not)	Tiptap 3.15.3 (StarterKit, Link, Placeholder, CharacterCount)
Editör (Markdown)	CodeMirror 4.25.4 (@uiw/react-codemirror)
Animasyon	Framer Motion 12.26.2
İkonlar	Lucide React 0.562.0
Tarih	date-fns 4.1.0
PWA	@ducanh2912/next-pwa 10.2.9

• PWA varsayılan olarak kapalıdır, açmak için next.config.ts dosyasına aşağıdaki değişikliği uygula:

// Satır 32-34

// (sil)
withPWA({
  dest: "public",
  disable: true,
  register: false,
})

// (ekle)
withPWA({
  dest: "public",
  disable: process.env.NODE_ENV === "development",
  register: true,
})

Sistem Gereksinimleri

Derlenmiş Uygulama

• Windows 10+ (64-bit)
• macOS 10.13+
• Linux: Ubuntu 18.04+, Fedora 32+, Debian 10+
• RAM: -
• Disk: 300MB boş alan

Geliştirme

• Node.js 18.x+
• npm 9.x+
• Git

Kurulum

# Depoyu klonlayın
git clone https://github.com/orgofjs/tubenotes-desktop.git

# Bağımlılıkları yükleyin
npm install

# Masaüstü için geliştirme
npm run electron-dev

# Windows için derleme
npm run build-win

# macOS için derleme
npm run build-mac

# Linux için derleme
npm run build-linux

Yapılandırma

Tema Özelleştirme

app/globals.css dosyasını düzenleyin:

:root[data-theme="dark"] {
  --color-bg: #0a0a0a;
  --color-primary: #ff0000;
}

Veri Konumu

• Windows: %APPDATA%/tubenotes/tubenotes.db (SQLite)
• macOS: ~/Library/Application Support/tubenotes/tubenotes.db
• Linux: ~/.config/tubenotes/tubenotes.db

Lisans

Apache 2.0 Lisansı - LICENSE dosyasına bakın.

---

English

TubeNotes is a modern visual knowledge management system for YouTube videos. Take video notes, visualize your ideas on infinite canvas, draw shapes, manage your Kanban tasks and add markdown notes. Available as desktop application (Windows, macOS, Linux).

Quick Start

• Step 1: Go to the Releases page.
• Step 2: Download the latest.
• Step 3: Install and start taking notes!

Key Features

• Kanban Task Mode
• Canvas Mode
• YouTube Video Notes
• Organization System
• Theme Support
• Search & Filtering
• Local Storage

Technologies

Category	Technology
Framework	Next.js 16.1.6 (App Router, Turbopack)
Desktop	Electron 40.0.0 + electron-builder
Database	SQLite (better-sqlite3 12.6.2)
ORM	Prisma 6.19.2 (schema definition)
Language	TypeScript 5
Styling	Tailwind CSS 4
Canvas	@xyflow/react 12.10.0 (React Flow)
Editor (Notes)	Tiptap 3.15.3 (StarterKit, Link, Placeholder, CharacterCount)
Editor (Markdown)	CodeMirror 4.25.4 (@uiw/react-codemirror)
Animation	Framer Motion 12.26.2
Icons	Lucide React 0.562.0
Date	date-fns 4.1.0
PWA	@ducanh2912/next-pwa 10.2.9

• PWA is disabled by default; to enable it, apply the following change in the next.config.ts file:

// Ln 32-34

// (delete)
withPWA({
  dest: "public",
  disable: true,
  register: false,
})

// (add)
withPWA({
  dest: "public",
  disable: process.env.NODE_ENV === "development",
  register: true,
})

System Requirements

Built Application

• Windows 10+ (64-bit)
• macOS 10.13+
• Linux: Ubuntu 18.04+, Fedora 32+, Debian 10+
• RAM: -
• Disk: 300MB free space

Development

• Node.js 18.x+
• npm 9.x+
• Git

Installation

# Clone repository
git clone https://github.com/orgofjs/tubenotes-desktop.git

# Install dependencies
npm install

# Development for desktop
npm run electron-dev

# Build for Windows
npm run build-win

# Build for macOS
npm run build-mac

# Build for Linux
npm run build-linux

Configuration

Theme Customization

Edit app/globals.css:

:root[data-theme="dark"] {
  --color-bg: #0a0a0a;
  --color-primary: #ff0000;
}

Data Location

• Windows: %APPDATA%/tubenotes/tubenotes.db (SQLite)
• macOS: ~/Library/Application Support/tubenotes/tubenotes.db
• Linux: ~/.config/tubenotes/tubenotes.db

License

Apache 2.0 License - see LICENSE file.

---

Made by orgofjs

Star | Report Bug | Request Feature