Wrot

by Vill Yoshioka
5
4
3
2
1
Score: 54/100

Description

An Obsidian plugin for micro-journaling your day, one "tweet" at a time.

Reviews

No reviews yet.

Stats

8
stars
6,203
downloads
1
forks
165
days
5
days
5
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
115
commits

Latest Version

5 days ago

Changelog

Important Changes

  • Replaced the "Open" command with commands that choose where to open Wrot. If you had a hotkey assigned to it, please reassign it.

New Features

  • Added commands to open Wrot in the left sidebar, right sidebar, or main area, and to open its settings

Improvements

  • Made the plugin lighter

Bug Fixes

  • Fixed quote cards in Live Preview sometimes not showing the colors of the quoted post's tag rule
  • Fixed URLs and quote links sometimes not being colored correctly while editing a post in Live Preview

🇯🇵 日本語版リリースノート

README file from

Github

Wrot

English ・ 日本語

Micro-journaling for Obsidian. Capture your day like you're tweeting to yourself.

License: MIT release

Wrot timeline in the main editor area


What is Wrot?

Write + Jot = Wrot. It brings effortless micro-journaling to Obsidian, combining the depth of writing with the speed of quick note-taking.

Think of it as your own private social feed. You get the quick, low-friction feel of posting online, but with zero algorithm, zero audience, and zero pressure. Dump random thoughts, quick updates, or fleeting ideas as they happen.

Because every post drops straight into your daily notes, Wrot works hand-in-hand with Obsidian’s native search and backlinks without breaking a sweat.


What you can do

  • A social-style timeline paired with a rich editor
    The editor hides Markdown syntax so bold text and lists look finished as you write (learn more). A customizable toolbar puts formatting, lists, quotes, and links within easy reach (learn more).
  • Keep important posts pinned
    Keep key posts or active tasks stuck to the top of your feed. You can even schedule a post to pin itself automatically on a future date (learn more).
  • Built right into Obsidian's tag system
    Tags in your posts act just like standard tags across your vault. They pop up in Graph View, show up in search, and open in Obsidian's global search with a click (learn more).
  • Tag autocomplete
    Type # in the input box to instantly see your most-used tags, making tagging fast and painless (learn more).
  • Tag rules with auto color-coding
    Set custom background and text colors for specific tags to visually group your feed by project, mood, or urgency (learn more).
  • Internal links and rich link previews
    Link to notes in your Vault or to web pages with the Link button, and paste URLs to generate rich OGP link cards, keeping your context clear at a glance (learn more).
  • Post under your template headings
    Pick a heading from your daily note template and your posts land right under it instead of at the end of the note. Templater-powered templates work too (learn more).
  • Hassle-free image attachments
    Paste images straight from your clipboard, drop them onto the screen, or pick files using the attachment button. Check thumbnail previews before hitting post.
  • Customizable look and feel
    Colors follow Obsidian's own look unless you pick your own, with separate light/dark mode color schemes, custom post button labels, and custom icons.

How it works

Wrot saves your entries as ```wr code blocks inside the file designated by Obsidian's Daily Notes plugin. No custom databases, no external servers, no vendor lock-in. Everything stays inside plain text files in your vault.

You can post, edit, and clean up entries directly from the timeline, or open the raw Markdown file whenever you prefer.

If you format your daily notes by week (like GGGG年WW週) or month (like YYYY年MM月), Wrot seamlessly adapts into a weekly or monthly log instead.

Note: Wrot relies on Obsidian's core Daily Notes plugin, so make sure it is turned on.


Requirements

  • Obsidian v1.14.4 or newer
  • Supported platforms
    • macOS
    • iOS / iPadOS
    • Windows (untested)
    • Linux (untested)
    • Android (untested)

Languages

Wrot supports 11 languages across 12 locales. It automatically follows your Obsidian interface language and falls back to English if your language isn't supported yet.

Language Locale Language Locale
Japanese ja French fr
English (US) en German de
English (UK) en-GB Italian it
Korean ko Russian ru
Spanish es Traditional Chinese zh-TW
Portuguese pt Simplified Chinese zh-CN

Quick Start

  1. Install Wrot through the Community Plugins tab or manually.
  2. Open your timeline by clicking the ribbon icon, or from the Command Palette with "Open in left sidebar", "Open in right sidebar", or "Open in main area".
  3. Start logging by writing a post and pressing the post button or hitting Ctrl / Cmd + Enter.

Installation

Via Obsidian Community Plugins

  1. Go to Settings > Community plugins > Browse.
  2. Search for Wrot and hit Install.
  3. Once downloaded, click Enable.

Manual Install

  1. Grab main.js, manifest.json, and styles.css from the latest Release.
  2. Move all three files into .obsidian/plugins/wrot/ inside your vault (create the wrot folder if needed).
  3. Open Settings > Community plugins in Obsidian, hit Reload, and enable Wrot.

Tip: The .obsidian folder is hidden by default. Press Cmd + Shift + . on macOS or turn on "Hidden items" under the View tab in Windows File Explorer to reveal it.


Customization

Wrot gives you fine-grained control over how your feed looks and behaves.

  • Panel location: Dock your timeline in the left sidebar, right sidebar, or main editor area.
  • Color themes: Customize light and dark mode colors independently.
  • Tag rules: Color-code specific tags for quick visual filtering.
  • Pinning: Limit pinned items (1, 3, or 5 posts) and keep pinned posts sticky at the top when scrolling.
  • Button setup: Customize post and update labels/icons, or hide the delete button from the post menu.
  • Timestamp format: Adjust how dates and times display (e.g., YYYY/MM/DD HH:mm:ss).
  • Link previews: Turn OGP link preview cards on or off.

Wrot timeline docked in the right sidebar


Privacy

Wrot does not track you or collect any data. Everything runs 100% locally on your device.

Note: If link previews are enabled, Wrot sends a standard web request to the destination URL to retrieve preview metadata.


License

MIT License

Thinking of forking Wrot? See About Forks.


Credits

Wrot was built standing on the shoulders of these incredible projects. Huge thanks to the creators:

Translations are powered by Nani. Special thanks to catnose (Kioku LLC) for such a helpful tool.


Behind the Scenes

The project author handles all design, architecture, and quality control, leveraging Anthropic's Claude as a development assistant. For more details, see our AI Use Policy.

Author: Vill Yoshioka (@villyoshioka)