📖 General & Usage
Q: 🧭 What is Chronicler?
A:
Chronicler is a free, offline worldbuilding tool for Windows, macOS, and Linux. It requires no account or internet connection. You build a private wiki using Markdown and wikilinks.
Q: 📈 Are there any limits on page count or size?
A:
No. You can create as many pages as you like, and they can be as long as you need. Chronicler imposes no limits.
Q: 🔤 What file formats and languages does it support?
A:
Notes are stored as plain-text Markdown (
.md) files. Chronicler also natively supports YAML, HTML, inline CSS, LaTeX (for math/formulas), and custom Chronicler syntax.Q: 🌍 Can I have multiple worlds or vaults?
A:
Yes! You can create unlimited vaults. A dedicated vault switcher remembers all of your worlds for easy swapping.
Q: 🖼️ How do I add images to an infobox?
A:
Ensure your images are saved somewhere inside your vault folder (e.g., in a dedicated
Read the Infobox Image Guide here.
/images folder). The infobox editor will find them automatically, or you can add them manually via YAML. Read the Infobox Image Guide here.
Q: 🤝 Can I share my vault with my players?
A:
Because Chronicler is 100% offline, you can easily share your world by syncing your vault folder via Google Drive, Dropbox, or Git. Your players simply install Chronicler on their end and load the shared folder.
Q: 📜 Is the Community License the Pro version?
A:
No. The Community License is strictly a donation. It does not unlock hidden features; it simply supports ongoing development and keeps the core app free for everyone.
Q: 🚚 Can I migrate from another tool?
A:
Yes. Built-in importers support Word/Google Docs (
.docx) and MediaWiki/Fandom (.xml dumps). It also works natively with existing Obsidian vaults—just point Chronicler at your folder.🐧 Platform & Compatibility
Q: 🍎 How do I install on macOS?
A:
Follow our official macOS installation guide at chronicler.pro/download.
Q: 🐧 I'm on Linux and Chronicler won't launch or shows a blank screen.
A:
This is a known upstream issue with WebKitGTK and the DMA-BUF renderer. Launch the app with this environment variable:
WEBKIT_DISABLE_DMABUF_RENDERER=1 ./Chronicler.AppImageLD_PRELOAD=/usr/lib/libwayland-client.so ./Chronicler.AppImageQ: 🐧 Chronicler crashes on Linux with a C++ vector assertion or font error.
A:
This is a known WebKitGTK bug related to rendering specific color emoji fonts (like
1. Remove the problematic font:
Noto-COLRv1.ttf). To fix this, you must replace the COLRv1 font with the standard TrueType version and disable the DMA-BUF renderer.1. Remove the problematic font:
sudo rm /usr/share/fonts/google-noto-color-emoji-fonts/Noto-COLRv1.ttfwget -O ~/.local/share/fonts/NotoColorEmoji.ttf https://github.com/googlefonts/noto-emoji/raw/main/fonts/NotoColorEmoji.ttffc-cache -fvWEBKIT_DISABLE_DMABUF_RENDERER=1 ./Chronicler.AppImageQ: 📱 Is there a mobile or web version?
A:
No. Chronicler is intentionally a desktop-only application to remain fast, private, and offline-first.
🛡️ Security & Licensing
Q: ⚠️ Why is my antivirus flagging Chronicler?
A:
You might see a warning from Windows Defender or other antivirus software. This is a false positive, and Chronicler is safe to use.
This happens because Chronicler is a new application from an independent developer and is not "code-signed" due to the prohibitive cost of certificates. Modern antivirus algorithms treat unsigned apps that access the file system with suspicion.
You can safely bypass the warning by clicking "More info" and then "Run anyway".
This happens because Chronicler is a new application from an independent developer and is not "code-signed" due to the prohibitive cost of certificates. Modern antivirus algorithms treat unsigned apps that access the file system with suspicion.
How to verify safety:
- Transparency: You can view the entire source code on GitHub.
- VirusTotal Scan: For peace of mind, you can upload the installer to VirusTotal to see it scanned by over 50 different antivirus engines.
- Signed Updates: While the initial installer is unsigned, all in-app updates are cryptographically signed to ensure they haven't been tampered with.
You can safely bypass the warning by clicking "More info" and then "Run anyway".
Q: 🔓 Is Chronicler open source?
A:
It is source-available. The code is public on GitHub, but it uses the PolyForm Shield License to prevent commercial cloning while remaining free for your personal use.