Table of Contents

• 🗂️ Yet Another Memos Sync
  • Table of Contents
  • Background
  • Features
  • Installation
  • Configuration
  • Usage
  • Visual Formats
  • Development
  • Contributing
  • License

Background

Yet Another Memos Sync is an enhanced Obsidian plugin that seamlessly synchronizes your Memos with daily notes. Inspired by the original obsidian-memos-sync plugin, this version offers advanced features including emoji timeline, intelligent formatting, and robust synchronization strategies.

Unlike basic sync tools, it provides visual enhancements, smart synchronization, and supports both modern and legacy Memos API versions.

Features

🔄 Smart Synchronization

• Incremental sync - Only updates changed content for better performance
• Time-limited sync - Configurable day limits (default: 30 days) to control sync scope
• Deletion detection - Automatically removes deleted memos from your notes
• Auto-sync options - Startup and periodic synchronization capabilities

🎨 Visual Enhancements

• List Callout Style - Enhanced Markdown lists with emoji timeline (recommended)
• Callout Format - Rich card-style presentation for detailed viewing
• Standard Format - Clean Markdown lists with emoji enhancements
• Multi-line support - Proper indentation handling for complex memo structures

🌍 Internationalization

• Full i18n support - English, Chinese, and extensible language system
• Auto-detection - Automatically detects your Obsidian language preference
• Consistent UI - Translated settings interface and user messages

⚙️ Flexible Configuration

• API version support - Uses the Memos /api/v1/memos API, with a v0.30 time-filter compatibility fallback
• Custom headers - Configurable memo section headers for organization
• Attachment handling - Download and organize memo attachments automatically
• Daily note integration - Seamless integration with Daily Notes plugin

Installation

Community Plugins (Recommended)

1. Open Obsidian Settings → Community plugins
2. Disable Safe mode if not already disabled
3. Click "Browse" and search for "Yet Another Memos Sync"
4. Install and enable the plugin

Manual Installation

1. Download the latest release from GitHub Releases
2. Extract the files to <vault>/.obsidian/plugins/yet-another-memos-sync/
3. Reload Obsidian and enable the plugin in Settings → Community Plugins

Build from Source

# Clone the repository
git clone https://github.com/exusiaiwei/yet-another-memos-sync.git
cd yet-another-memos-sync

# Install dependencies
npm install

# Build the plugin
npm run build

Configuration

Basic Setup

1. Open Settings → Yet Another Memos Sync
2. Add a profile and configure your Memos server:
   • API URL: Your Memos server address (e.g., https://your-memos.com)
   • API Token: Generate from your Memos settings page
   • Daily Notes Header: Match the heading in your daily-note template exactly. No API version selector is required.

Visual Style Selection

Choose one format that best suits your workflow:

• 🎨 List Callout Style: Enhanced lists with emoji timeline (recommended with List Callouts plugin)
• 📋 Callout Format: Rich card-style presentation for detailed viewing
• 📝 Standard Format: Simple emoji-enhanced Markdown lists

Advanced Configuration

Usage

Basic Operations

• 🔄 Manual Sync: Click the sync button in the ribbon or use Command Palette (Ctrl/Cmd + P → "Sync Memos")
• ⚡ Force Sync: Re-sync all memos, ignoring incremental sync cache
• 🤖 Auto Sync: Automatically syncs on Obsidian startup and at periodic intervals (if enabled)

Command Palette Commands

• Yet Another Memos Sync: Sync Memos - Standard incremental sync
• Yet Another Memos Sync: Force Sync All Memos - Complete re-sync
• Yet Another Memos Sync: Open Settings - Quick access to plugin settings

Visual Formats

🎨 List Callout Style (Recommended)

The List Callout style creates beautiful, themed memo lists that integrate seamlessly with the List Callouts plugin:

- 🌅 07:30 Morning coffee and planning the day
  - Reviewed project timeline
  - Prepared meeting agenda
- ☀️ 14:20 Productive afternoon work session
- 🌆 18:30 Evening wrap-up and notes review
- 🌙 22:15 Late night reading session

When paired with List Callouts plugin, each time period gets beautiful colored themes

📋 Time Period Mapping

The plugin uses a simplified 4-period emoji system for intuitive time organization:

🔄 Other Format Examples

Callout Format

> [!memo] 🌅 07:30 Morning Memo
> Planning the day with coffee ☕
> - Review project timeline
> - Prepare meeting agenda

Standard Format

- 🌅 07:30 Morning coffee and planning
- ☀️ 14:20 Productive work session
- 🌆 18:30 Evening wrap-up

Development

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Development Setup

# Clone the repository
git clone https://github.com/exusiaiwei/yet-another-memos-sync.git
cd yet-another-memos-sync

# Install dependencies
npm install

# Development mode with auto-rebuild
npm run dev

# Build for production
npm run build

# Run tests
npm test

Supported Memos Versions

• v0.30: In use by the maintainer. YAMS 1.6.2 added a fallback for HTTP 400 responses caused by changed CEL time-filter types; time limits are still applied locally.
• v0.28: The API response fields are handled, but issue #5 reports a successful sync notification without new content. The report lacks the installed YAMS version and logs, so its cause remains unconfirmed.
• Other versions are not covered by a full compatibility test matrix. Matching API fields alone does not prove end-to-end compatibility.

If sync reports success without writing records, check the installed YAMS version, enabled profile, sync days limit, and exact daily-note heading. Incremental sync only fetches newly created memos; try Force Sync All Memos after checking these settings. When reporting an issue, include server/plugin versions and relevant console or sync errors, with tokens and private content removed.

Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

• 🐛 Report bugs via GitHub Issues
• 💡 Suggest features through GitHub Discussions
• 🔀 Submit pull requests for improvements
• 📖 Improve documentation and translations
• 🌟 Star the repository to show your support

Development Guidelines

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to the original obsidian-memos-sync plugin for inspiration
• Memos for the excellent memo platform
• Obsidian for the powerful note-taking platform
• List Callouts plugin for beautiful visual themes

Local time records

Set Local time records → Time record heading to a title distinct from every Memos sync heading. This setting is blank by default. Enable and configure Obsidian’s Daily notes core plugin first.

Run Add time record, enter text, then select Add and open (or press Ctrl/Cmd + Enter). The command adds a list item with a local-time emoji and HH:mm, opens the daily note, and places the cursor at the end of the record. Enter inserts a newline; continuation lines are indented. Empty input and cancellation do not write anything.

The timestamp and destination date are captured when the dialog opens, including across midnight. Missing daily notes are created using the daily-note template, and a missing destination is added as a level-2 heading. This explicit command creates the note regardless of the automatic sync “Create missing daily notes” setting. Records stay local and require no Memos account. Their separate section is preserved by sync. You can then start Text Block Timer manually; List Callouts styling is optional. Neither plugin is required.