{"id":50752158,"url":"https://github.com/andresousadotpt/macdaily","last_synced_at":"2026-06-11T02:04:54.356Z","repository":{"id":363921765,"uuid":"1265503378","full_name":"andresousadotpt/macdaily","owner":"andresousadotpt","description":"A native macOS app for writing one markdown note per day.","archived":false,"fork":false,"pushed_at":"2026-06-11T00:00:20.000Z","size":5325,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T00:14:49.409Z","etag":null,"topics":["daily","mac","macos","note-taking","notes","notes-app"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andresousadotpt.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-10T20:45:50.000Z","updated_at":"2026-06-10T23:59:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/andresousadotpt/macdaily","commit_stats":null,"previous_names":["andresousadotpt/macdaily"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/andresousadotpt/macdaily","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andresousadotpt%2Fmacdaily","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andresousadotpt%2Fmacdaily/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andresousadotpt%2Fmacdaily/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andresousadotpt%2Fmacdaily/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andresousadotpt","download_url":"https://codeload.github.com/andresousadotpt/macdaily/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andresousadotpt%2Fmacdaily/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34178824,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["daily","mac","macos","note-taking","notes","notes-app"],"created_at":"2026-06-11T02:04:53.636Z","updated_at":"2026-06-11T02:04:54.351Z","avatar_url":"https://github.com/andresousadotpt.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# macdaily\n\nA native macOS app for writing **one markdown note per day**. Each day gets its own file (`2026-06-10.md`) in a folder you choose. Optional daily reminders nudge you to write.\n\n![macdaily demo — daily note editor with sidebar and menu bar](docs/demo.gif)\n\n## Install\n\n### Option A — Build from source (recommended)\n\nNo Gatekeeper warnings when you build locally.\n\n```bash\ngit clone https://github.com/andresousadotpt/macdaily.git\ncd macdaily\nmake app\nopen dist/macdaily.app\n```\n\nRequirements: macOS 14 (Sonoma) or later, Xcode Command Line Tools. Full Xcode is needed for `make test`.\n\n### Option B — Homebrew\n\n```bash\nbrew tap andresousadotpt/tap\nbrew install --cask macdaily\n```\n\nIf macOS blocks launch the first time, right-click `macdaily.app` → **Open**, or use System Settings → Privacy \u0026 Security → **Open Anyway**.\n\nBuild from source (Option A) avoids this entirely.\n\n### Option C — GitHub Release\n\nDownload `macdaily-{version}.zip` from [Releases](https://github.com/andresousadotpt/macdaily/releases), unzip, and open the app. Same Gatekeeper note as Option B.\n\n## Usage\n\n1. Launch macdaily and choose a notes folder.\n2. Today's note is created automatically — on launch, at local midnight, when the Mac wakes, and when the app returns to the foreground.\n3. Use the **menu bar icon** (book) for quick access: edit today's note in the popover or click **Open macdaily** for the full window.\n4. Pick earlier days from the sidebar.\n5. Open **Settings** (⌘,) to change the notes folder, configure daily reminders, customize appearance, or back up settings.\n\nSettings are saved automatically to `~/Library/Application Support/MacDaily/config.json`. Use **Settings → Backup** to export or import a JSON file (appearance, shortcuts, reminders, and startup — not your notes folder path).\n\n### Appearance\n\nSettings → **Appearance** lets you adjust:\n\n- **Editor zoom** — slider or **⌘+** / **⌘−** / **⌘0** (View menu) to zoom in, out, or reset\n- **Theme** — light, dark, or follow system; optional high-contrast text\n- **Editor** — font style, line spacing, margins, line numbers, default editor/split/preview view\n- **Preview formatting** — pick a preset theme (GitHub, Monokai, Dracula, One Dark, Nord, Tokyo Night, Gruvbox, Solarized, Ocean, Forest, and more) or switch to **Custom** to fine-tune each element\n- **Sidebar** — show or hide the daily note count\n\n### Formatting \u0026 shortcuts\n\nUse **Format** menu shortcuts (defaults shown) or change them in Settings → **Shortcuts**:\n\n| Action | Default shortcut |\n| ------ | ---------------- |\n| Bold | ⌘B |\n| Italic | ⌘I |\n| Strikethrough | ⌘⇧X |\n| Underline | ⌘U (inserts HTML tags) |\n| Inline code | ⌘E |\n| Link | ⌘K |\n| Heading 1–6 | ⌘⌥1 … ⌘⌥6 |\n\nThe editor can show **line numbers** in a left gutter (toggle in Settings → Appearance).\n\nCode blocks in the preview use **syntax highlighting** when you specify a language (e.g. ` ```swift `). Click the **copy** icon on a code block to copy its contents.\n\nClosing the main window keeps macdaily running in the **menu bar** so you can keep jotting notes from there.\n\nOn first launch, macdaily asks for **notification permission**, a **notes folder**, and whether to **open at login** (on by default). Change startup behavior anytime in Settings → General.\n\n### Reminders\n\nDefault reminder times are **9:30 AM**, **1:00 PM**, and **4:00 PM** (your Mac's local time). You can add, edit, or remove times in Settings → Reminders. macOS will ask for notification permission the first time reminders are enabled.\n\nReminders only work when running the packaged app (`make app` → `open dist/macdaily.app`). They are skipped under `make run` / `swift run`, which does not run inside a proper `.app` bundle.\n\n## Development\n\n```bash\nmake build    # debug build\nmake run      # build and launch via swift run (reminders skipped)\nmake test     # unit tests (requires full Xcode, not Command Line Tools alone)\nmake app      # release .app in ./dist — use this to test reminders\nmake clean    # remove build artifacts\n```\n\n## Releasing\n\nVersion lives in `packaging/Info.plist` (`CFBundleShortVersionString`). Push to `main` and GitHub Actions will:\n\n1. Auto-bump the patch version if `v{current}` already exists (e.g. `0.1.0` → `0.1.1`)\n2. Build `macdaily.app` (ad-hoc signed)\n3. Publish a GitHub Release zip\n4. Update the Homebrew cask in [homebrew-tap](https://github.com/andresousadotpt/homebrew-tap)\n\nFor a **minor** or **major** release, bump locally first:\n\n```bash\nmake bump-version BUMP=minor   # or BUMP=major\ngit add packaging/Info.plist \u0026\u0026 git commit -m \"chore: bump version to X.Y.Z\"\n```\n\nThen merge to `main`. CI will use that version as-is (no tag exists yet) and publish it.\n\n### CI secrets\n\n| Secret | Required | Purpose |\n| ------ | -------- | ------- |\n| `HOMEBREW_TAP_TOKEN` | For automated tap updates | GitHub PAT with `contents: write` on `homebrew-tap` |\n\nApple Developer ID / notarization is **not** required. Releases are ad-hoc signed.\n\n## Contributing\n\nContributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, code guidelines, and pull request expectations.\n\n| Document | Purpose |\n| -------- | ------- |\n| [CONTRIBUTING.md](CONTRIBUTING.md) | How to contribute |\n| [SUPPORT.md](SUPPORT.md) | Help, FAQs, and where to ask questions |\n| [SECURITY.md](SECURITY.md) | Report vulnerabilities privately |\n| [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) | Community standards |\n| [CHANGELOG.md](CHANGELOG.md) | Version history |\n| [AGENTS.md](AGENTS.md) | Architecture reference for developers and AI agents |\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandresousadotpt%2Fmacdaily","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandresousadotpt%2Fmacdaily","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandresousadotpt%2Fmacdaily/lists"}