Skip to content

jokroese/tiddlyroam

Repository files navigation

TiddlyRoam

Your open-source external brain.

Description

TiddlyRoam is an open-source tool for organising your thoughts, ideas, and research by building your own personal wiki. It’s designed to capture your knowledge in small, interconnected notes and help you discover new patterns through bi-directional links.

The project provides a free and open-source alternative to the popular Roam, built on the highly customisable TiddlyWiki.

Key Features

  • Bi-directional Links: See not only the pages you link to but also the pages that link back to the current page, helping you build a web of interconnected ideas.
  • Graph Maps: Visualise the structure of your wiki with interactive maps, allowing you to explore relationships between your notes visually.

How to Use TiddlyRoam

TiddlyRoam is designed for everyone—no technical skills required! You can start using it right away by following the steps below:

  1. Download the latest version of TiddlyRoam:
  2. Download TiddlyDesktop:
    • Install TiddlyDesktop, which allows you to save your changes easily.
  3. Run TiddlyRoam:
    • Open TiddlyDesktop.
    • Drag the tiddlyroam.html file into the TiddlyDesktop window or use the file picker to open it.
    • Start adding your notes, and TiddlyRoam will help you organise them!

Quickstart for Development

If you’re a developer interested in customising or contributing to TiddlyRoam, follow these steps to set up the development environment using a modular, Node.js-based workflow.

  1. Clone the repository:
    git clone https://github.com/jokroese/tiddlyroam.git
    cd tiddlyroam
  2. Install dependencies:
    npm install
  3. Start the development server:
    npm run dev
  4. Open your browser and navigate to http://localhost:8080 to see the live TiddlyWiki.
  5. To build the distributable single HTML file:
    npm run build
    This will generate the tiddlyroam.html file for distribution.

Acknowledgements

TiddlyRoam combines the amazing work of the following open-source projects:

I hope this is useful for you Ellis.

License

This project is licensed under the BSD 2-Clause License. You are free to use, modify, and distribute the software with attribution, as long as you follow the license terms.