FraGament Reference Guide

1. What is FraGament?

FraGament is a completely local note-taking app designed to capture the “fragments of awareness” that arise while you are engaged with a work — games, books, movies, videos, and more.

Features like short tags, session time tracking, automatic saving, and JSON backup make it useful not only for journaling, but also for reviews, analysis, and creative work.

2. Titles and Fragments

● Title

A title represents the top-level unit of your notes. You can create one for each game, book, movie, or any work you engage with.

● Fragment

A fragment is a card where you write down individual insights that arise during play, reading, or viewing. The first line becomes the headline; the rest is completely free-form.

・Automatic tag extraction
・Sorting by time
・Linked to sessions
These functions all integrate with fragments inside FraGament.

3. Memo Editor

The memo editor in FraGament is powered by CodeMirror 6. Everything you type is saved instantly to IndexedDB (fully local / automatic saving).

● Automatic Tag Extraction

Hashtags like #tag are extracted in real-time and displayed in the fragment list.

● Markdown Mode

Each fragment can toggle Markdown mode on or off. Tap the M icon in the upper-right corner of a fragment card to switch.

When Markdown mode is on, your memo is rendered as a formatted preview. Click the preview to switch to edit mode; unfocus to return to preview.

Supported elements: headings / lists / code blocks / tables / strikethrough / task lists
Checkboxes in task lists are clickable directly in the preview.

● Image Attachment

You can attach screenshots and other images to fragments.
When you open Quick Capture, any image on your clipboard is loaded automatically — no key press needed.
You can also paste with Ctrl+V, or tap the area to select a file.

Attached images are saved locally in the browser's Origin Private File System (OPFS).
Images are included in the ZIP file when you export.

4. Short Tag List (@...)

In FraGament, typing @f or@t and pressing enter will automatically convert the input into a tag.

The format of time-based tags changes depending on “Include time in short tag” in the settings:
#fun-1:23 (hyphen)
#fun 1:23 (space)

Input	Output	Meaning
@now	Current time	Insert system timestamp
@uid	uid:xxxx	User ID
@tid	tid:xxxx	Title ID
@sid	sid:xxxx	Session ID
@fid	fid:xxxx	Fragment ID
@a	#angry	Anger / frustration
@b	#bad	Bad moment / negative scene
@c	#cut	Clip-worthy moment
@d	#death	Death event / fatal scene
@e	#event	Event / key scene
@f	#fun	Fun moment
@g	#good	Good moment / positive impression
@h	#hint	Hint / foreshadowing
@i	#idea	Idea / thought
@j	#joke	Joke / funny line
@k	#key	Key moment / important clue
@l	#love	Affection / favorite moment
@m	#memo	Additional memo
@n	#note	Note / annotation
@o	#oops	Mistake / slip-up
@p	#0:15 etc.	Session elapsed time
@q	#quest	Quest / task
@r	#reveal	Reveal / truth uncovered
@s	#sad	Sad moment
@t	#1:15:30 etc.	Total time for title
@u	#unlock	Unlock / breakthrough
@v	#voice	Notable voice line / dialogue
@w	#wow	Wow moment / amazement
@x	#extra	Extra info / details
@y	#yummy	Tasty moment / emotionally flavorful
@z	#zoom	Focus point / highlight
@!	#surprise	Surprise / shock
@?	#question	Question / mystery

Tags convert when typing patterns like @t⏎.

5. Session Tracking

Each time you open a title, a new session is automatically created. A session represents a block of working or thinking time.

・Start / end time
・Real-time elapsed time
・Number of fragments created in the session

All of this helps connect your progress — reading, play, or work — to your changing thoughts.

6. Export / Import

● Export

All data can be exported as a single ZIP file.
The ZIP includes both the text data (JSON) and all attached images.

● Import

You can restore data or migrate to another device. The file format is detected automatically.

ZIP format (new): Restores both text data and images.
JSON format (legacy): Restores text data only (backward compatible).

※ Importing will overwrite all existing data.

7. Settings

Language (Japanese / English)
Auto-create first fragment when opening a title
Fragment order (Updated / Created)
Fragment tap behavior (Mobile)
Font size
Line height
Autosave delay
Include time in short tags

8. Export (Text / Markdown)

You can merge all fragments and export them as a draft for reviews.

Text (.txt)
Markdown (.md)