https://github.com/andjar/notd

yet another notetaking system
https://github.com/andjar/notd

js notetaking outliner php todo

Last synced: about 2 months ago
JSON representation

yet another notetaking system

• Host: GitHub
• URL: https://github.com/andjar/notd
• Owner: andjar
• Created: 2025-05-21T17:54:22.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2026-02-20T01:26:14.000Z (4 months ago)
• Last Synced: 2026-02-20T04:32:01.624Z (4 months ago)
• Topics: js, notetaking, outliner, php, todo
• Language: PHP
• Homepage: https://andjar.github.io/notd/
• Size: 6.05 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# notd - A Note-Taking Application

Welcome to **notd**, a simple and flexible outliner! **notd** is designed to help you effortlessly organize your thoughts, tasks, and information. Dive in and discover a more intuitive way to keep your digital life in order! Built with robust technology, focusing on longevity. The data are saved as clear text (unless specifically encrypted) in a sqlite database. Heavily inspired by [LogSeq](https://logseq.com/)

## 🌟 Frontend Features

**notd** provides a rich, interactive frontend experience with powerful features:

### 📝 **Rich Note-Taking**

- **Markdown Support** - Write with familiar Markdown syntax and live preview

- **Page Linking** - Connect ideas with `[[Page Name]]` syntax  

- **Transclusion** - Embed content with `{{transclude:Note Title}}`

- **SQL Queries** - Execute dynamic queries with `SQL{...}` syntax

### 🔐 **Security & Privacy** 

- **Client-Side Encryption** - AES-256 encryption with `ENC{...}` syntax

- **Password Protection** - Secure sensitive content with per-page passwords

- **Offline-First** - Works completely offline, your data stays with you

### ✅ **Task Management**

- **Multiple Task States** - TODO, DOING, DONE, WAITING, CANCELLED, and more

- **Visual Indicators** - Color-coded task states with checkboxes

- **Property-Based Organization** - Tag tasks with priority, assignee, due dates

- **Kanban Board Extension** - Visual task management with drag-and-drop

### 🔍 **Powerful Search & Navigation**

- **Global Search** - Find content across all notes and pages instantly

- **Property Filtering** - Search by any custom property

- **Backlink Discovery** - See which pages reference your current page

- **Favorites System** - Quick access to important pages

### 🧩 **Extension Ecosystem**

8 built-in extensions for specialized workflows:

- **🎨 Excalidraw Editor** - Drawing and diagramming

- **📋 Kanban Board** - Visual task management

- **📎 Attachment Dashboard** - File management

- **🧮 Math Notepad** - Mathematical notation

- **⏲️ Pomodoro Timer** - Time management

- **📰 RSS Handler** - Feed integration  

- **📧 Mail Handler** - Email integration

- **🧘 Zen Mode** - Distraction-free writing

### 📅 **Journal-Based Organization**

- **Daily Pages** - Automatic date-based pages for journaling

- **Calendar Navigation** - Visual date navigation with activity indicators

- **Hierarchical Organization** - Nest pages with forward-slash notation

- **Template System** - Reusable note and page templates

## Main Features

*   **Effortless Note-Taking & Organization:** Easily create, manage, and nest rich-text notes within a flexible page hierarchy. Organize notes into distinct pages (including special 'Journal' pages for daily logs) and navigate your collection with ease.

*   **Customizable Properties:** Personalize notes and pages with custom properties (like `{status::todo}` or `{priority::high}`) for powerful filtering, organization, and automation.

*   **Integrated File Attachments:** Keep all related information in one place by attaching files directly to your notes.

*   **Powerful Global Search:** Instantly find what you need across all your notes with a comprehensive search.

*   **Time-Saving Note Templates:** Create notes faster for recurring formats like meeting notes or bookmarks using predefined or custom templates.

*   **Visual Calendar Navigation:** Use the calendar widget to visually explore and access your notes by date.

*   **Discover Connections with Backlinks:** Uncover relationships between your notes and pages by seeing what links to them.

*   **Easy Markdown Formatting:** Write and format notes effortlessly using Markdown.

*   **Responsive & Fast:** Enjoy a smooth and speedy experience as you navigate and manage your notes.

## Plan Forward / Roadmap

**notd** is under active development.

## Getting Started / Installation

Setting it up is straightforward. You'll generally need a web server environment with PHP and SQLite support.

1.  **Server Environment:** Make sure your web server is ready to serve the application files and has PHP and SQLite capabilities.

2.  **Permissions:** Ensure the web server has write permissions for the `db/` directory (or the custom path you set in `config.php` for your database).

3.  **Configuration:** If `config.php` doesn't exist, copy `config.php.example` to `config.php`. You can then update `DB_PATH` in `config.php` if you wish to store the database in a custom location (default is `db/notd.sqlite`).

4.  **Launch:** Open **notd** in your web browser by navigating to its URL on your server. Enjoy!

The application is also designed with [phpdesktop](https://github.com/cztomczak/phpdesktop) in mind, allowing it to be packaged as a standalone desktop application. If using a phpdesktop build, refer to its specific instructions.

## Contributing

We warmly welcome contributions to **notd**! Whether you have ideas for new features, bug fixes, or general improvements, your help is appreciated.

Ready to contribute? Feel free to open an issue to share your thoughts or submit a pull request with your changes. We're excited to see what you come up with!