DayLeaf Calendar User Manual

1. About DayLeaf Calendar

DayLeaf Calendar is a desktop calendar app for Windows that recreates the warmth and fun of a "tear-off paper calendar" in digital form.

Record your daily notes and ideas intuitively, just like "tearing off" a calendar page each day.
Add and organize "Notes", "Hand-drawn Doodles", and "File Attachments" for each date.
Enjoy convenient features such as drag & drop, Undo/Redo, and automatic backup.
All data is stored locally on your PC—no cloud or external servers are used.
Supports multiple languages (Japanese/English), theme switching, sound ON/OFF, and more customization options.

Key Features of DayLeaf Calendar

"Tear-off" animation and sound, just like a paper calendar
Manage multiple notes, doodles, and files per date
Trash feature for safe deletion and easy recovery
Simple data migration and backup
Convenient desktop features like auto-start on Windows and "Always on Top"

Recommended for:
・Those who want to keep a daily record
・Those who want to organize work or study progress by date
・Fans of the paper calendar feel
・Those who want to safely manage important data on their own PC

2. Screen Layout & Main Features

Full screen image

DayLeaf Calendar centers around the "Main Calendar", with an intuitive layout including a Control Panel and Edit Modal.

2.1 Overall Layout

Title Bar: App name and window controls (Minimize, Maximize, Reload, Help, Close)
Main Calendar: Pages for each date (front/back, with flip animation).
"Notes", "Doodles", and "Files" are layered for each date.
Control Panel: Buttons for Today, Previous Week, Previous Day, Flip, Next Week, Edit, Open Date Directory, Layers, Settings, etc.
Edit Modal: Add/edit "Notes", "Doodles", and "Files" for the selected date.
Layer Modal: Toggle ON/OFF for each content type (Notes, Doodles, Files).
Settings Modal: Change app-wide settings such as language, theme, sound, and data storage location.
File Rename/Copy Progress Bar: Auxiliary screen for file operations.

Tip: All areas support not only mouse operations but also drag & drop and right-click menus.

2.2 Details & Main Features

Main Calendar:
・Flip pages with animation to move between dates
・Add, arrange, and edit "Notes", "Doodles", and "Files" for each date
・Drag items to adjust position, right-click to edit or delete
Control Panel:
・Today: Jump to today's date
・Previous Week/Day, Next Week: Move by week/day
・Flip: Flip to the next date
・Edit: Open the edit modal for the selected date
・Open Date Directory: Open the data folder for that date in Explorer
・Layers: Toggle content display
・Settings: Open app settings
Edit Modal:
・Notes Tab: Add/edit text notes (choose color, size, background)
・Doodles Tab: Draw illustrations/diagrams (pen/eraser/undo/clear/save/cancel)
・Files Tab: Drag & drop to attach files, rename or delete files
Layer Modal:
・Toggle display of "Notes", "Doodles", and "Files" with one click
Settings Modal:
・Set language, theme, sound, animation, window, data storage, thumbnail size, auto icon arrangement, startup date, developer mode, etc.
File Rename/Copy Progress Bar:
・Shows progress for file renaming and copying

Point: All operations are managed "per date", making it easy to edit, back up, or restore only specific days.

3. Basic Usage

Basic operation demo (page flipping, notes, doodles, file operations)

3.1 Moving Between Dates

Use the "Flip" or arrow buttons to move between dates, just like a paper calendar.
Click the "Today" button to instantly return to today's date.

Tip: You can also move between dates using the mouse wheel or arrow keys (depending on version).

3.2 Adding & Editing Notes, Doodles, and Files

Example: How to record a day
1. Move to the date you want to record
2. Click the "Edit" button
3. Enter text in the "Notes" tab, choose color/size, and click "Save"
4. Draw in the "Doodles" tab and click "Save"
5. Drag & drop files in the "Files" tab to attach them

You can add multiple notes, doodles, and files per date.
Drag items to adjust their position, right-click to edit or delete.
Undo/Redo is available for editing operations.

Example: Adding & editing notes, doodles, and files (new video)

3.3 Drag & Drop, Preview, and Explorer Integration

Add files by dragging them directly to the Files tab or the main calendar.
Rename, delete, preview files, or open them in Explorer.
Batch delete multiple files and change thumbnail sizes.

3.4 Layers & Display Customization

Use the "Layers" button to toggle the display of notes, doodles, and files with one click.
With "Auto Icon Arrangement" ON, items outside the screen are automatically aligned.

3.5 Customizing Settings

Freely change themes (Washi, Classic, Modern, Dark, etc.), sounds, and animations.
Set data storage location, startup date, and window behavior in detail.
Some settings take effect after restarting the app.

Point: All operations are saved "per date", making it easy to edit, back up, or restore only specific days.

4. Trash & Data Safety

DayLeaf Calendar features a unique trash system that allows you to easily restore accidentally deleted notes, doodles, and files.
Data migration and backup are also designed for safety, with robust mechanisms to protect your important records.

4.1 Trash System Highlights

Deleted items are not immediately erased, but moved to a dedicated "Trash" folder.
Check and restore data from the "Trash List" screen.
Trash data retains original file names and locations.
Even if you delete files with the same name multiple times, they are safely managed (unique IDs are automatically assigned).
Data remains in the trash until you manually restore it.
The app's trash is managed separately from Windows' Recycle Bin.

Note: To permanently delete data in the trash, manually delete the trash folder using Explorer, etc. (Permanent deletion cannot be done from the app.)

4.2 How to Restore from Trash

Click the "Trash List" button in the settings screen
Click the "Restore" button for the item you want to recover
The data will be returned to its original location (if a file with the same name exists, you will be prompted to overwrite)

Tip: You can also open the trash folder itself in the OS Explorer.

4.3 Data Safety Design

Delete operations only move data to the trash. Data is never immediately erased or overwritten by normal operations.
Data migration (changing storage location) is by copy—the original data always remains.
Even in case of errors or cancellation, the original data is never lost.
Backup and restore can be done easily by folder.

Point: The design minimizes the risk of accidentally losing important data and ensures safe management.

5. Data Storage, Backup & Migration

DayLeaf Calendar stores all data in a "data folder" on your local PC.
No cloud or external servers are used, so you can change the storage location or back up data yourself using standard file operations.

5.1 Data Folder Structure

Data is organized by date, with "Notes", "Doodles", and "Attachments" neatly arranged for each day.

/
  └─ YYYY/
      └─ MM/
          └─ DD/
              ├─ memos/         ... Note data (JSON files)
              ├─ drawings/      ... Doodle data (JSON files)
              ├─ files/         ... Attached files/folders
              ├─ file_positions.json ... File position info

memos/: Each note is saved as a JSON file (content, color, position, size, creation date, etc.)
drawings/: Each doodle is saved as a JSON file (drawing path, position, size, creation date, etc.)
files/: Attached files and folders are stored as-is
file_positions.json: Manages on-screen position info for attached files/folders

5.2 How to Back Up

To back up, simply copy the entire data folder to a USB drive, external HDD, etc.
You can also back up or restore only specific dates.
For safety, perform backup/restore after closing the app.

5.3 How to Migrate Data (Change Storage Location)

Change the "Data Storage Location" in the settings screen
Current data will be copied to the new location (the original data remains)
After copying, you can continue working in the new location

Point: Even during migration, the original data is never deleted. It's safe even if an error or cancellation occurs.

5.4 Notes on Storage Location

You cannot specify the app's install folder or subfolders of the old data folder as the storage location.
Safe example: C:\Users\YourName\Documents\MyCalendarData — we recommend a new folder unrelated to the app or old data folders.
If you want to use a subfolder of the old data folder, copy it elsewhere first, then specify it.

Note: Files or folders with the .asar extension may cause errors during data migration or copy operations.
These files/folders are not supported as normal DayLeaf Calendar data.
If an error occurs, you can either exclude .asar files/folders from the copy target, or avoid the issue by manually copying them using Windows Explorer or other OS file tools.
This is due to limitations in the app framework (Electron/Node.js), which restricts copying certain special files via the app's internal process.

6. Settings & Customization

DayLeaf Calendar offers rich customization features. Adjust appearance, behavior, data storage, and more from the settings screen.

Language: Switch between Japanese and English
Theme: Washi, Classic, Modern, Four Seasons, Dark, and more
Sound: Toggle page flip sound ON/OFF, adjust volume with slider
Page Flip Animation: Choose from Classic, Slide, Fade, Zoom, Flip, Wipe
Thumbnail Size: Change image/video thumbnail size from Small (48px) to XXL (210px)
Window: "Always on Top" ON/OFF, "Auto-start with Windows" ON/OFF
Data Storage Location: Change/migrate storage folder (specify with "Select..." button)
Auto Icon Arrangement: ON automatically aligns items outside the screen
Startup Date: Choose "Today" or "Last Closed Date"
Developer Mode: ON enables developer tools (F12/Ctrl+Shift+I)

* Some settings (language, theme, developer mode, etc.) take effect after restarting the app.

Tip: Open the settings screen anytime from the "Settings" button in the control panel.

7. Troubleshooting & FAQ

7.1 Troubleshooting

If you get errors when saving or handling files, check available space and access permissions for the storage location.
If settings are not applied, restart the app.
If file previews do not work, check if the format is supported.
When migrating data, make sure copying is complete before deleting old folders.

Tip: Most issues can be resolved by "restarting", "checking storage location", or "updating to the latest version".

7.2 Frequently Asked Questions

Q. Where is my data stored?
A. By default, in your user data folder, but you can change/migrate it from settings.
Q. How do I back up or migrate data?
A. Changing the "Data Storage Location" will automatically migrate existing data.
Q. Can I change the theme or language anytime?
A. Yes, from "Settings" at any time.
Q. How do I delete or rename files?
A. Use the Files tab in the edit modal.
Q. What if notes or doodles are misaligned?
A. Turn ON "Auto Icon Arrangement".
Q. Are shortcut keys available?
A. Not implemented yet, but planned for future versions.

9. Shell Copy Feature (Advanced File Copy)

Shell Copy feature screenshot

The Shell Copy feature uses Windows OS commands (robocopy, xcopy, etc.) to powerfully and safely copy files that may fail with the app's normal copy, such as special files (e.g., .asar files or certain system files).

Files that cause errors with the app's normal copy can often be copied successfully with Shell Copy
Real-time display of copy progress, detailed logs, and error messages
Easy to use via the "Shell Copy" button in the Files tab or by drag & drop
Destination is automatically sorted by calendar date

9.1 How to Use

Open the "Files" tab in the Edit Modal
Click the "Shell Copy" button or drop files into the drag & drop area
The copy will start, and progress/logs/errors will be shown on screen
After completion, files are automatically added to the file list for that date

9.2 Advantages & Features

Can copy special files (like .asar) and large files that may fail with normal copy
High reliability by using standard Windows OS commands
Real-time feedback: progress, errors, and detailed command output
Supports clipboard copy and batch copy of multiple files

9.3 Notes

Other operations are temporarily restricted during copying (please wait until completion)
Because OS commands are used, antivirus software may show warnings
Files requiring admin rights or locked files may not be copied
If copying fails, check available disk space and file status

Note: Shell Copy is especially effective for special files (such as .asar or some system files) that cause errors with the app's normal copy.
You can also check detailed progress and error messages, which helps in troubleshooting.

10. Shortcuts & Useful Features

* Shortcut key operations (e.g., F12, Ctrl+Shift+I) are not implemented yet.
We are considering shortcut support in future versions.

Add files via drag & drop
Open files/folders in Explorer instantly
Undo/Redo (when editing notes/doodles)
Instantly switch thumbnail size or theme
Trash list & restore feature
Desktop app features like "Always on Top" and "Auto-start"

Tip: We plan to add more useful features based on user feedback.

11. Support & Contact

For questions or issues, please contact us via the in-app help or the developer contact below.
Developer Contact: Udon Soba yosuke4061@gmail.com

Tip: Please also refer to "7. Troubleshooting & FAQ" in this manual for common questions and solutions.

12. Libraries & License Information

▲ Back to Table of Contents

Application License

This software is protected by copyright law and international treaties.
Unauthorized reproduction, distribution, or modification of this software is prohibited by law.

Terms of Use:
1. The right to use this software is granted only to license purchasers.
2. Purchasers may install and use this software on one device.
3. Reverse engineering or decompiling this software is prohibited.
4. This software is provided "as is" without any warranty.
5. The author is not liable for any damages arising from the use of this software.

Open Source Libraries Used

Electron (MIT License)
https://github.com/electron/electron
electron-store (MIT License)
https://github.com/sindresorhus/electron-store
uuid (MIT License)
https://github.com/uuidjs/uuid
iconv-lite (MIT License)
https://github.com/ashtuchkin/iconv-lite
Node.js Standard Modules (MIT License)
- path, fs, child_process, os
https://github.com/nodejs/node

Full MIT License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

(For libraries under the MIT License, the above conditions apply.)

Please use each library/binary included in this software in accordance with its respective license terms.

Message from the Developer

Thank you very much for using DayLeaf Calendar.
This app is made possible by the power of many open source communities and the feedback of our users.
We will continue to improve DayLeaf Calendar to make "daily record-keeping more enjoyable".
We hope you will continue to enjoy using it.
- Udon Soba (Developer)