/obsidian-perilous-writing

An Obsidian plugin which demands writing output, at the threat of bludgeoning your in-progress work.

Primary LanguageTypeScriptMIT LicenseMIT

Perilous Writing

An Obsidian plugin which demands writing output, at the threat of bludgeoning your in-progress work. Emulates Manu Ebert's excellent The Most Dangerous Writing App.

Try it out! ↗

[☨] (Experimental—bug reports welcome.)

Usage

Warning: If a session is not completed successfully then your in-session work will be irrevocably deleted. Caveat emptor.

  1. Install the plugin. See below.

  2. Open the command palette and choose either a short session (default of five minutes), a long session (default of ten minutes), or a custom-length session. (The respective default durations can be changed in the settings tab.)

    image
  3. A light gray bar will appear at the top of the editor. It represents the session's progress. The session will begin after the next keypress.

    image
  4. Begin writing. If you stop writing for five seconds your in-session additions will be deleted. You'll be warned after two seconds of inactivity.

    image image image
  5. Only new characters reset the timer—backspace does not. Neither do normal-mode operations under Vim emulation. On completion of a successful session, progress is preserved.

    image
  6. Remove the progress bar with the “Clear session” command.

Installation

Community Plugins

Search for “Perilous Writing” in the community plugins tab.

Manual

Download the latest release, and copy the main.js, styles.css, and manifest.json files into a new plugin directory, like (4) and (5) below.

From source

  1. Clone the repository.

  2. Install the dependencies. Through yarn or npm install in the directory root.

  3. Build the plugin with yarn build or npm run build. This will produce a main.js file.

  4. Create a directory for the plugin in your vault's directory.

    mkdir -p $VAULT_SOURCE/.obsidian/plugins/perilous-writing
  5. Copy the main.js, styles.css, and manifest.json files into that directory.

    cp main.js styles.css manifest.json $VAULT_SOURCE/.obsidian/perilous-writing
  6. Enable the plugin in Obsidian's settings tab.

Acknowledgements

Inspired by Manu Ebert's The Most Dangerous Writing App.