Kiroku User Guide
Welcome to Kiroku
Kiroku is a visual weekly planner. Your week appears as a colorful grid — each column is a day, and each row is an hour. Create tasks by clicking and dragging directly on the grid.
All your data stays on your device. No account required.
Table of Contents
- The top bar - Create a task - Switch weeks - Choose a date range - Workspaces- General
- Styles
- Overlay
- Days
- Tasks
- Colors
- Alerts
- Calendar
Get started
Open Kiroku in your browser or the Windows desktop app. Your current week appears automatically.
To plan your first task:
The task appears on the grid immediately. Hover over it to see its start time, end time, and duration.
The main view
The top bar
The top bar contains navigation controls and quick-access buttons.
- Month and year. Displays the current month (such as "March 2026").
- Task type buttons. Colored buttons for each task category. The selected type has a glowing border. Hover over a button to see its name.
- Workspace switcher. A dropdown that appears when you have more than one workspace.
- Prev / Next arrows. Move one week backward or forward.
- Today. Return to the current week.
- Zoom level. Displays the current zoom percentage when not at 100%.
- Icon buttons. From left to right: Time Tracking (bar chart), Daily Summary (bell), Calendar View (calendar), Dark Mode (moon or sun), Settings (gear).
Day columns
Each day has its own column with the following elements:
- Header. Shows the day number and name (such as "19 Wed"). Today's header is highlighted in blue. Holidays appear in red text when turned on. If a day has multiple holidays, the first is shown with a "+1" badge — hover to see all.
- Grid. Solid lines mark each hour. Dashed lines mark the half hour. Faint vertical lines help you position tasks precisely.
- Current time marker. A red highlight on today's column shows the current time. It updates automatically.
- Hour lines. Bold horizontal lines you can add in Settings to mark important times.
- Background colors. Columns alternate between two background colors. You can customize weekday and weekend colors separately.
Hour markers
Small numbered circles appear along the left edge of each column, one for each hour (0 through 23).
Click any marker to cycle through three states:
- Normal. A subtle circle with the hour number.
- Highlighted. A bold, filled circle that stands out.
- Hidden. The marker is not visible.
Notes and hours summary
Below each day's header:
- Total time. The total scheduled time for that day (such as "2 hours and 30 minutes"). If no tasks are scheduled, it reads "No tasks."
- Notes. A text area for quick notes about that day. Click to edit, and the notes save automatically when you click away or press Tab. Press Escape to discard changes.
Create, edit, and delete tasks
Create a task
Tasks snap to 5-minute intervals. The minimum task duration is 5 minutes.
Resize a task
Move your pointer to the top or bottom edge of a task until the cursor changes. Click and drag to make the task longer or shorter.
Tasks snap to 5-minute intervals when resizing.
Move a task
Click and drag from the center of a task to reposition it.
Do any of the following:
- Change the time. Drag the task up or down within the same column.
- Change the day. Drag the task left or right to a different column.
The task saves to its new position when you release.
Add text to a task
- Press Enter to save and close.
- Press Shift + Enter to add a new line.
- Press Escape to cancel without saving.
- Click Save or Cancel.
Text appears directly on the task block. Long text is truncated with an ellipsis.
Delete a task
Do either of the following:
- Use the editor. Double-click the task, then click Delete. Confirm when prompted.
- Press and hold. Hold the pointer on a task for 3 seconds without moving. A confirmation dialog appears. If you move the pointer during the hold, the action is cancelled and the task is dragged instead.
The current time indicator
A red highlight appears on today's column showing the current time. It updates in real time and appears only on today's column.
Manage task types
Task types are categories with assigned colors. Every task belongs to one type. Kiroku includes five default types:
To customize task types, go to Settings > Tasks.
You can rename any type, change its color, add new types, or delete types you no longer need. If tasks exist that use a type you delete, you are prompted to confirm before those tasks are removed.
View task details on hover
When you hover over a task, an info overlay appears with details about it.
The overlay can show:
To customize which fields appear, the overlay position, time format, and hover delay, go to Settings > Overlay.
Navigate your schedule
Switch weeks
- Click Prev to go back one week.
- Click Next to go forward one week.
- Click Today to return to the current week.
The month and year in the top bar update as you navigate.
Zoom in and out
Hold Ctrl and scroll the mouse wheel to zoom. Five zoom levels are available:
The zoom level appears in the top bar when not at 100%. The view remains centered on the area you are viewing.
Turn on dark mode
Click the moon icon in the top bar. All interface elements update to a dark color scheme.
To return to light mode, click the sun icon. Your preference is saved automatically.
Track your time
Click the bar chart icon in the top bar to open Time Tracking.
Choose a date range
Use the From and To date pickers at the top. Click either to open a calendar. Use the arrows to change months. Click Today to set both dates to the current day.
If no tasks exist in the selected range, a message indicates this.
Click X to close.
View time breakdowns
For each task type with scheduled time in the date range, the following appears:
- The type name with its color.
- Total hours spent on that type.
- A proportional colored bar for visual comparison.
View daily timelines
Below the totals, each day is shown as a horizontal 24-hour timeline with colored bars at the actual times of your tasks.
- Hover over a bar to see its time range, duration, and text.
- Time markers appear at 6 AM, 9 AM, 12 PM, 3 PM, 6 PM, and 9 PM.
- Total time for each day appears on the right.
View the daily summary
Click the bell icon in the top bar.
The daily summary shows:
- Total number of tasks and total time planned for today.
- A breakdown by task type (such as "3 Work tasks — 4 hours").
- Day notes, if any.
This is a read-only overview. Close it to make changes on the grid.
Use the calendar view
Click the calendar icon in the top bar.
The calendar displays three months at once. Each day shows:
- Colored bars representing tasks (up to 5 visible, with a "+2 more" indicator for additional tasks).
- Holiday names, if holiday countries are configured.
- Background colors matching your column settings.
Click any day to jump to that week in the main view. Today is marked with a colored circle.
To navigate:
- Click « or » to jump 3 months.
- Click ‹ or › to move 1 month.
- Click Today to return to the current month. This button appears only when you have navigated away.
Write day notes
Every day includes a notes area below the header.
Press Escape to discard changes. Day notes also appear in the Daily Summary.
To change the notes font size, go to Settings > Days.
Clear all tasks for a day
Settings
Click the gear icon in the top bar. The Settings panel has 9 tabs. Click any tab name to switch to it. Click outside the panel to close it.
Workspaces
Workspaces are separate environments, each with its own tasks, categories, colors, and settings.
Each workspace appears as a card. The active workspace is labeled "Active." Other workspaces show a Switch button.
Do any of the following:
- Rename a workspace. Click the workspace name and type a new name.
- Switch workspaces. Click Switch on any workspace card.
- Delete a workspace. Click the × button. This option appears only when you have more than one workspace. Confirm when prompted.
- Add a workspace. Click + Add Workspace. A new workspace is created with default settings.
When you have multiple workspaces, a dropdown in the top bar lets you switch without opening Settings. A checkmark indicates the active workspace.
Tip: Create separate workspaces for different areas of your life — one for school, one for work, one for personal plans.General
The General tab manages your data and provides account utilities.
Export your data
Click Export to download all workspaces, tasks, settings, and notes as a .tdb file. The file name includes the current date.
Import data from a backup
.tdb file.Clear all tasks
Displays the number of tasks in the current workspace. Click Clear all tasks and confirm to delete them. Settings, notes, and other workspaces are not affected.
Reset to defaults
Erases all workspaces, tasks, notes, and settings and returns the app to its initial state.
Important: This action cannot be undone. Export your data first.Client ID
A unique identifier for your browser. Click Copy to copy it to your clipboard. This code persists even after a reset.
Styles
Control how tasks appear on the grid.
Choose a task appearance
Three visual styles are available:
- Normal. Solid colored blocks with clean edges.
- Highlighter. Translucent colors with a slight text tilt, resembling a highlighter pen. Use the opacity slider to adjust transparency.
- Office. A faint colored background with a bold stripe on the left edge, similar to Outlook or Google Calendar. Use the opacity slider to adjust the background intensity.
Set overlap indicators
When tasks overlap, the overlapping area can be marked with a visual pattern.
Choose from: None, Solid, Crosshatch, Dots, Diagonal, or Lines.
For any option other than None, you can also set the pattern color (from your palette) and adjust the opacity.
Adjust text size
Use the slider to set the font size for task text. The range is 8 to 24 pixels. The default is 13.
Choose a font
The available fonts depend on the selected task appearance.
Highlighter style — handwriting fonts:- Caveat — Clean and legible handwriting
- Patrick Hand — Friendly and rounded
- Shadows Into Light — Light and elegant
- Indie Flower — Casual and sketch-like
- Kalam — Bold, brush-style handwriting
- Architects Daughter — Technical drawing style
- Permanent Marker — Thick marker pen
- Inter — Modern and highly readable (default)
- Roboto — Clean and versatile
- Open Sans — Friendly and clear
- Lato — Warm with soft edges
- Source Sans 3 — Professional and clean
- Nunito — Rounded and approachable
- IBM Plex Sans — Precise and technical
Each font includes a preview showing sample task text.
Overlay
Configure the info overlay that appears when you hover over a task.
Choose which fields to show
Turn on or turn off each field independently:
- Start Time — When the task begins
- End Time — When the task ends
- Duration — How long the task lasts
- Text — The task label
- Task Type — The category name
Set the overlay position
Choose where the overlay appears on screen:
- Top Left, Top Right, Bottom Left, Bottom Right — Fixed in a corner.
- Centered — Fixed in the center of the screen.
- Mouse — Follows the pointer.
Choose a time format
- Short. 24-hour format with abbreviations (such as "09:30 · 4H 5M").
- Long. 12-hour format with full words (such as "9:30 AM · 4 Hours 5 Min").
Set the hover delay
Use the slider to set how long you must hover before the overlay appears. The range is 0 to 10 seconds. Set to 0 for instant display.
Days
Configure which days are visible and how columns appear.
Choose visible days
Seven buttons represent each day of the week. Click to show or hide individual days. At least one day must remain visible.
Two presets are available:
- All — Show Sunday through Saturday.
- Weekdays — Show Monday through Friday only.
Adjust cell size
Use the slider to set the column width, from 20 to 100 pixels. You can also type an exact value.
Adjust font sizes
Two sliders control text size:
- Notes Font — Font size in the notes area (8 to 24 pixels).
- Hours Font — Font size for the total hours display (8 to 24 pixels).
Set column backgrounds
Set background colors for four column types:
- Even columns — The 1st, 3rd, 5th columns.
- Odd columns — The 2nd, 4th, 6th columns.
- Saturday — A dedicated color for Saturday. Click "--" to follow the even/odd pattern.
- Sunday — A dedicated color for Sunday.
Click any color from your palette to apply it.
Configure hour markers
A grid of 24 buttons (0 through 23) appears in two rows. Click any hour to cycle through Normal, Highlighted, and Hidden states.
Hover over a button to see its current state.
Adjust marker size
Use the slider to set the hour marker size, from 16 to 48 pixels. The default is 28.
Add hour lines
Hour lines are bold horizontal lines that span the grid at specific times.
Each line has:
- A time picker (hour and minute in 5-minute steps).
- Day buttons to choose which days the line appears on. New lines default to Monday through Friday.
- A delete button (×) to remove the line.
Click + Add Line to create a new line.
Tip: Add lines at 9:00 AM, 12:00 PM, and 5:00 PM to mark the start of work, lunch, and end of day.Tasks
Manage the task type categories that appear as colored buttons in the top bar.
Each task type displays as a card with:
- A colored square showing the current color.
- An editable name field.
- Color swatches from your palette.
- A delete button (×).
Colors
Manage the color palette used throughout the app for task types and backgrounds.
Active palette
Your selected colors appear at the top (up to 20). Click any color to remove it from the palette. At least one color must remain.
Click Reset to defaults to restore the original 20 colors.
Color catalog
A library of 120 colors organized into six groups:
- Pastels (30) — Soft, light tones
- Warm (20) — Reds, oranges, yellows
- Cool (20) — Blues, teals, cyans
- Earth (20) — Browns, tans, olives
- Jewel (15) — Rich, saturated tones
- Neutral (15) — Grays and silvers
Click a color in the catalog to add it to your active palette. Colors already in your palette have a highlighted border. The palette has a maximum of 20 colors.
Alerts
Configure browser notifications for task reminders and daily overviews.
Turn on notifications
Turn on the toggle at the top. Your browser requests permission to send notifications. Click Allow when prompted.
If notifications are blocked, follow the on-screen instructions to update your browser permissions.
Sound
Turn on or turn off the notification sound. Sound is on by default.
Task reminders
Turn on to receive a notification before each task begins. Choose your reminder interval:
1 min · 2 min · 5 min · 10 min · 15 min · 30 minThe selected interval has a highlighted border.
Daily summary notification
Turn on to receive a daily overview of your scheduled tasks. Use the time slider to choose when the notification is sent — from midnight to 11:00 PM. The selected time is displayed next to the slider.
Tip: Set the daily summary to the time you start your day.Calendar
Configure holiday display and custom calendars.
Choose where holidays appear
Two options are available:
- Show in header. Holidays appear in the day header below the day name.
- Show in column. Holidays appear as markers on the grid.
Turn on either or both options.
Select holiday countries
Choose which countries' public holidays to display. Use the search field to filter the list by name or country code.
Each country row shows:
- A checkbox to select or deselect the country.
- The country flag and name.
- The country code (such as "US" or "DE").
- An expand arrow (▼) to view all holidays for the current year.
Selected countries appear as pills above the list. Click × on a pill to remove it.
Import a custom calendar
Import your own dates from a text file.
The file format is:
My School Holidays 2026
2026 : 0101 : New Year's Day
2026 : 0321 : Spring Break Starts
2026 : 0328 : Spring Break Ends
2026 : 1225 : Christmas
The first line is the calendar name. Each subsequent line follows the format: year : mmdd : description (where mmdd is the month and day — 0321 means March 21).
Save the file as .txt and click Import to load it.
After importing, you can:
- Turn on or turn off the calendar with its checkbox.
- Expand (▼) to view all dates.
- Export (↓) to download it as a text file.
- Delete (✕) to remove it.
Pop-up notifications
When notifications are turned on (in Settings > Alerts), notification banners slide in from the right side of the screen.
- Multiple notifications stack vertically.
- Each notification has a close button (X).
- Click a Daily Summary notification to open the full Daily Summary view.
Keyboard shortcuts
Privacy and data
- Your data stays on your device. All data is stored in your browser's local storage. Nothing is sent to any server. There is no tracking, analytics, or account system.
- Client ID. A unique identifier stored in your browser. It persists across resets and can be used to link your data or transfer it between browsers.
- Back up regularly. Go to Settings > General and click Export to save a backup file. Use Import to restore from a backup at any time.
- Browser data affects your tasks. Clearing your browser data removes Kiroku data. Always export before clearing.
- Devices do not sync. Each browser and device has its own independent data. Use Export and Import to transfer data between devices.
- The desktop app stores data locally on your computer using the same approach.