shuttlespace / tidgi-desktop

TidGi is an privatcy-in-mind, automated, auto-git-backup, freely-deployed Tiddlywiki knowledgement Desktop app, with local REST API. 「 太记 」是一个基于「 太微 TiddlyWiki 」的知识管理桌面应用，能保护隐私内容、高级自动化、自动Git云备份、部署为博客，且可通过RESTAPI与Anki等应用连接。（迭代开发中欢迎试用，开发进度见下方链接）(Under active development, see website below for details)

TidGi 太记

macOS	Linux	Windows	Maintainer

TidGi - Customizable personal knowledge-base with git as backup manager and blogging platform. （Used to be TiddlyGit)

太记 - 可定制性极强的个人知识管理系统，使用 Git 作为备份管理器和博客平台。

最新版下载按钮 Download

Load NodeJS Wiki 加载 NodeJS 版维基

Create Local Wiki 新建本地维基	Clone Online Wiki 下载云端维基

Translation, Preferences 多语言翻译和设置界面
Interactive code 交互式代码执行

最新版下载按钮 Download

相关介绍

用 TiddlyWiki 替代 Notion 和 EverNote 作为个人知识管理系统(Chinese)

For mac users, since I haven't buy Apple developer key yet, so you have to entrust App to open it, click here to expand details.

Mac 使用者点击这里展开操作方法，我费劲办法也申请不到苹果开发者账号，所以你得手动信任这个应用 ◀

First of all, you need to drag this App into Applications folder! Otherwise there will be an error.

首先你得把应用拖入「应用程序」文件夹才能使用！不然会弹一个报错框。

Click "Cancel" 点击「取消」 ↓

Click "Open" 点击「打开」 ↓

Click "OK" 点击「允许」 ↓

About TidGi-Desktop 关于「太记-桌面版」

---

TidGi is a cross-platform Note Taking & GTD & Fragment Knowledge Management desktop app powered by nodejs-TiddlyWiki, it ship with a lot of tiddlywiki plugins from the TiddlyWiki community.

You can call it TG-Note, it is totally free and you own all your data. Code by the people, build for the people.

---

「太记」是一个跨平台的笔记软件、时间和任务管理工具、碎片化知识管理工具，此乃其桌面版。「太记」基于强大的 NodeJS 版「太微（TiddlyWiki）」 构建，并带上了大量来自太微社区（TiddlyWiki community）的插件。

「太记」来自 TiddlyWiki 的译名「太微」，以及曾用名 TiddlyGit 首字母的谐音（后来我们又根据中文谐音把英文名改成了 TidGi）。当然你也可以直接叫它 TGNote，镰锤 ☭ 笔记。

为什么把 TiddlyWiki 翻译成「太微」？因为受到 @pimgeek 的启发：TiddlyWiki 可以干很多细致轻量的工作，但也从不限制用法，可以无限组合叠加。故以其首字母音译为「太微」，TiddlyWiki 可以称为「太微笔记」「太微万能抽屉」「太微卡片盒」……

太微垣，三垣之一，按《步天歌》，太微垣為三垣的上垣。 太微垣又名天庭，是政府的意思，也是貴族及大臣們居住的地方。

Data Privacy Protection 数据隐私保护

You can choose storage provider for your wiki workspace:

1. "Github" as unlimited storage and gh-pages blogging platform.
2. "Local" will create a local git repo for you, you can use GithubDesktop to sync manually.
3. "Gitlab" and "Gitee" is on the way

---

你可以选择你的 WIKI 工作区的存储服务提供商：

1. 「Github」是一个无限存储空间、可以用 GH-Pages 部署博客的平台。
2. 「本地」模式会创建一个本地仓库来备份你的 WIKI，你可以用 GithubDesktop 来手动同步内容到云端。
3. 「Gitlab」和「码云」还待支持，不过架子已经搭好了。

Differences from TiddlyDesktop? 与 TiddlyDesktop 的差别？

---

1. NodeJS version of TiddlyWiki have seamless auto-save experience, which is taking the advantage of SyncAdaptor instead of Saver, TG have better support for NodeJS wiki
2. Using NodeJS wiki, We can have separated tiddler files, which can be modified by hand, or by other programs (e.g. VSCode with VSCode-TW5-Syntax)
3. Though TiddlyDesktop can also load wiki folder generated by nodejs-TiddlyWiki, TG can backup that folder to the Github easily
4. With the Electron technology, we can use fs, git and many other nodejs things within TiddlyWiki, which greatly extend the hackability, which is the reason why I choose TiddlyWiki as my daily KM tool

---

1. 太微的 NodeJS 版本有无缝的自动保存体验，这是利用 SyncAdaptor 技术（而不是 Saver ）带来的的优势，太记对 NodeJS wiki 有更好的支持，而 TD 主要支持 HTML 版单文件 WIKI，各有优势。
2. 使用 NodeJS wiki 时，我们可以有分离的 tiddler 文件，这些文件可以手工修改，也可以由其他程序修改（例如装了 VSCode-TW5-Syntax 的 VSCode)，而且方便细粒度备份回滚
3. 尽管 TiddlyDesktop 也可以加载由 nodejs 版太微生成的 wiki 文件夹，但太记还可以轻松地将该文件夹自动备份到 Github 上。
4. 通过使用 Electron 技术，我们可以在太微中使用 fs 、 git 和许多其他 nodejs 的扩展接口，这大大扩展了插件可使用的能力。这种可扩展性也是我选择太微作为我日常知识管理工具的原因，太记进一步强化了它。

Why Github?

---

Because Github is one of the best free civil level BaaS:

1. Its storage is basically free, allow us to store unlimited images and PDF files, which can have permanent URIs for public download
2. It has GraphQL API that allow us programmatically update our wiki
3. It has free CI to automatically deploy our TiddlyWiki blog
4. It provides unlimited repository, public and private, which enables us to store private content into our TiddlyWiki

---

因为 Github 是最好的免费民用级存储即服务（BaaS）之一。

1. 它的存储基本上是免费的，允许我们存储无限的图像和 PDF 文件，这些文件可以有永久的 URI 供公众下载。
2. 它有 GraphQL API，允许我们以程序化的方式更新我们的 wiki。
3. 它有免费的CI来自动部署我们的太微博客。
4. 它提供了无限数量的代码仓库，分为公共的和私有的，这使我们能够将私有内容存储到我们的太微中仅在本地查看，然后只把公开部分部署成博客。

Download

Just download it from Github Release Free Download

You can also find changelog in the Release.

Stargazers over time

Please give a star if you like it!

Development

Development plan of TidGi-Desktop is listed in these Kanban.

Explanation of our code can be found in the Wiki.

To contribute, fork this repo, then clone it and setup development environment

# First, clone the project:
git clone https://github.com/YOUR_ACCOUNT/TidGi-Desktop.git
cd TidGi-Desktop
# Or maybe you are just using Github Desktop
# or GitKraken to clone this repo,
# and open it in your favorite code editor and terminal app

# switch to the nodejs version same as electron used version, other wise you may get

# Error: The module '/Users/linonetwo/Desktop/repo/TidGi-Desktop/node_modules/opencv4nodejs-prebuilt/build/Release/opencv4nodejs.node'

# was compiled against a different Node.js version using

# NODE_MODULE_VERSION 88. This version of Node.js requires

# NODE_MODULE_VERSION 93. Please try re-compiling or re-installing

# the module (for instance, using `npm rebuild` or `npm install`).

# See https://github.com/justadudewhohacks/opencv4nodejs/issues/401#issuecomment-463434713 if you still have problem rebuild opencv for @nut-tree/nut-js

nvm use

# install the dependencies

npm i

# Run development mode

# You can see webpack error messages in http://localhost:9000/

npm start

# Build for production

npm run package

Publish

Add a tag like vx.x.x to a commit, and push it to the origin, Github will start building App for all three platforms.

After Github Action completed, you can open Releases to see the Draft release created by Github, add some comment and publish it.

Developer FAQ And Code Tour

Developer FAQ and code explained

Credits

The desktop app shell is based on https://github.com/atomery/singlebox and atomery/webcatalog, they provide lots of utils around website-generated-app, much powerful than generating app from website simply using Chrome. Also the independent developer @quanglam2807 behind these great tools helps me a lot when I develop TidGi.

Current Icon is download from iconsdb under Creative Commons Attribution-NoDerivs 3.0 , if you are a designer, please feel free to contribute your ICON if you have a better idea.