This guide describes the app as shipped in the mydays project. Menu labels match the English UI.
Table of contents
Main screen
The main screen is titled Diary. It shows entries for the currently selected book, filtered to a selected month.
Area | What it does |
|---|---|
Top left — ⋯ | Opens the More menu (import, export, merge, search, settings). |
Top center — book chip | Tap to switch the active book. |
Top right — + | Create a new entry. |
Bottom — month controls | Previous month, month picker, next month. |
Bottom — text mode | Toggle between short preview lines and full entry text. |
List | Entries for the active book and month. Tap a row to edit. |
Sunday dates are highlighted in the accent color on the left date column.
Books
A book is a separate notebook (for example “Journal”, “Travel”, or “book 1”). Each entry belongs to exactly one book.
Manage books in Settings
Open Settings from the More menu (see below), then scroll to Books.
Action | How |
|---|---|
Add book | Tap Add Book at the bottom of the book list. Enter a name and tap Create. |
Rename | Swipe a book row left, tap Rename, enter the new name. |
Delete | Swipe left, tap Delete (red). You must type the book name exactly on the confirmation screen. You cannot delete the last remaining book. |
After you add or remove books in Settings, close Settings to return to the diary. The main screen updates the active book if needed.
Entries
Create an entry
Tap + (top right).
Choose the date (defaults to today).
Write your text.
Optionally attach media (see Attachments).
Tap Save.
Edit an entry
Tap the entry in the list. Change the date, text, or attachment, then Save.
Cancel editing
Tap Cancel. If you changed anything, the app asks whether to Discard Changes or Keep Editing.
Delete or share an entry
Swipe an entry row left:
Action | Effect |
|---|---|
Delete | Removes the entry permanently. |
Share | Opens the system share sheet with the entry text. |
Empty entries
If the body is empty, the list shows (empty). You can still save an entry with only an attachment.
Month navigation
Entries are grouped by calendar month.
Control | Effect |
|---|---|
◀ / ▶ | Move to the previous or next month that has entries in this book. |
Month chip (bottom) | Opens a wheel picker for year and month. The range is limited to months that contain at least one entry in the current book. Tap OK to apply. |
Only entries in the selected month appear in the list (unless you are in Search mode).
Text display mode
At the bottom right, use the text display segmented control (two icons: short left-aligned lines vs. full justified text):
Segment | Behavior |
|---|---|
Compact (left icon) | Entry body is limited to two lines per row. |
Full text (right icon) | Shows the full body; row separators are hidden for a cleaner look. |
This setting affects the list only, not the editor. VoiceOver labels it Text display mode.
Search
Open ⋯ → Search.
A search field appears at the top of the diary.
Type to search all entries in the current book (case-insensitive, body text only).
Results are grouped by year–month (localized labels), oldest month first, entries in date order within each month.
Tap a result to edit it.
Dismiss search (system search dismiss) to return to the normal month-filtered list.
Attachments
Each entry can have at most one attachment: a photo or a video.
In the entry editor
Control | Effect |
|---|---|
Photo icon (toolbar) | Opens the system photo picker (images or videos). |
Thumbnail (below text) | Tap to view full-screen; tap anywhere to close. |
✕ on thumbnail | Removes the attachment before you save. |
Videos that are too large (about 48 MB or more) are rejected with a message.
In the entry list
If an entry has an attachment, a small thumbnail appears on the right of the row. Tap it for a full-screen preview (tap anywhere to close). Videos show a play icon in the thumbnail.
More menu (⋯)
Tap ⋯ at the top left.
Command | Description |
|---|---|
Import Blogger Entries | Import entries from a Blogger Atom ( |
Export Blogger Entries | Export the current book as an Atom file and share it via the system share sheet. |
Merge Entries in Same Day | In the current book, combines multiple entries on the same calendar day into one entry (bodies joined with a newline, ordered by time that day). Keeps one attachment from the group if present. |
Search | Opens entry search (see Search). |
Settings | Opens Settings (font, background, books). |
Settings
Open ⋯ → Settings. Tap Done when finished.
Entry font
Control | Description |
|---|---|
Font name | Shows the current font family. Tap Select Font to open the system font picker (iOS font list). |
Font size | Slider from 8 pt to 30 pt (default 17 pt). Applies to the entry list, editor, and the sample preview below. |
Preview | Two sample lines showing how entries will look. |
Background
Control | Description |
|---|---|
Choose from Album | Sets a custom background image for the entry list (and navigation area when an image is set). |
Clear Background | Removes the custom background. |
The background is stored on this device only (not in iCloud book sync). It respects light and dark appearance (a dim overlay is applied).
Books
See Books.
Share from other apps
mydays includes a Share extension. From apps such as Safari, Notes, or Mail, use Share → mydays to save text or a URL into a diary entry.
Open mydays at least once so your book list is available to the extension.
In another app, share text or a link to mydays.
On the share sheet:
Choose the book.
Choose the entry date (defaults to today).
Review the preview.
Tap Save. The extension closes; the entry is added when mydays next runs or returns to the foreground.
If no books appear, open the main app once, then try again.
Import and export (Blogger Atom)
These commands work with Blogger-style Atom XML (common for blog exports).
Import
Select the target book on the main screen.
⋯ → Import Blogger Entries.
Pick an Atom/XML file.
Entries are created in the current book with dates and bodies from the file.
Export
Select the book to export.
⋯ → Export Blogger Entries.
The app builds an Atom file and opens the share sheet so you can save or send it.
Merge entries on the same day
⋯ → Merge Entries in Same Day (current book only):
For each calendar day that has more than one entry, those entries are merged into one.
Bodies are combined in time order, separated by a single newline.
If the kept entry has no attachment, an attachment from another entry that day may be copied over.
Extra entries that day are deleted.
A message reports how many entries were merged, or that none were found.
iCloud and data
Books and entries use SwiftData with CloudKit when iCloud is available on the device.
If iCloud is not ready, the app falls back to local storage on the device.
Custom list background images are stored in app preferences on the device, not in the CloudKit diary data.
The Share extension queues new entries through a shared app group; the main app imports them when it is active.
Sign in to iCloud and enable iCloud for mydays in Settings → [your name] → iCloud on the device for sync across your Apple devices.
Permissions
The app may request:
Permission | Used for |
|---|---|
Photo Library | Entry attachments and optional list background image. |
Contacts | Not required for core diary use (legacy strings may remain in the project for older features). |
Notifications | Background capability for remote notifications (if configured in a future build). |
Tips
Switch books from the center chip on the main screen before writing or importing.
Use full text mode when reviewing long entries; use short lines for a compact month overview.
Search searches the whole book, not only the visible month.
Before deleting a book, export it with Export Blogger Entries if you want a backup.
After changing books in Settings, tap Done so the diary refreshes the active book.
Attachments are included in iCloud sync; very large videos may be slow to sync or hit platform limits.
Document information
Item | Value |
|---|---|
App name | mydays |
Guide language | English |
File |
|
For the latest app behavior, refer to the mydays source repository and in-app English strings.
沒有留言:
發佈留言