{"id":50873521,"url":"https://github.com/pehqge/macconvert","last_synced_at":"2026-06-15T07:05:56.714Z","repository":{"id":363941006,"uuid":"1265648672","full_name":"pehqge/macconvert","owner":"pehqge","description":"Convert any file from Finder's right-click menu — 45 native macOS Quick Actions. Images, video, audio, PDF, documents, ebooks + Send to Kindle.","archived":false,"fork":false,"pushed_at":"2026-06-11T03:05:58.000Z","size":5749,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T03:10:58.578Z","etag":null,"topics":["automator","ffmpeg","file-conversion","finder","imagemagick","kindle","macos","pandoc","quick-actions","zsh"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/pehqge.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"pehqge","buy_me_a_coffee":"pehqge"}},"created_at":"2026-06-11T00:58:48.000Z","updated_at":"2026-06-11T03:06:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pehqge/macconvert","commit_stats":null,"previous_names":["pehqge/macconvert"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/pehqge/macconvert","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pehqge%2Fmacconvert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pehqge%2Fmacconvert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pehqge%2Fmacconvert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pehqge%2Fmacconvert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pehqge","download_url":"https://codeload.github.com/pehqge/macconvert/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pehqge%2Fmacconvert/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34351474,"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-15T02:00:07.085Z","response_time":63,"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":["automator","ffmpeg","file-conversion","finder","imagemagick","kindle","macos","pandoc","quick-actions","zsh"],"created_at":"2026-06-15T07:05:54.635Z","updated_at":"2026-06-15T07:05:56.676Z","avatar_url":"https://github.com/pehqge.png","language":"Shell","funding_links":["https://github.com/sponsors/pehqge","https://buymeacoffee.com/pehqge"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eMacConvert\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eConvert files from Finder's right-click menu. 45 native Quick Actions.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/pehqge/macconvert/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/pehqge/macconvert/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/pehqge/macconvert/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/pehqge/macconvert?color=blue\" alt=\"Release\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/macOS-12%2B%20·%20Apple%20Silicon%20%26%20Intel-black?logo=apple\" alt=\"macOS\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sponsors/pehqge\"\u003e\u003cimg src=\"https://img.shields.io/badge/sponsor-%E2%9D%A4-db61a2?logo=githubsponsors\u0026logoColor=white\" alt=\"Sponsor\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/hero.png\" alt=\"Finder right-click menu with MacConvert Quick Actions\" width=\"780\"\u003e\n\u003c/p\u003e\n\nRight-click a file, pick a conversion under **Quick Actions**, and the\nconverted copy lands next to the original. That's the whole workflow. Behind\nit sit the tools you'd reach for anyway (ffmpeg, ImageMagick, Pandoc,\nGhostscript), wired into Finder so you never have to open a terminal or, worse,\nupload your files to some converter website.\n\n## Install\n\n```sh\nbrew install pehqge/tap/macconvert\nmacconvert setup\n```\n\nOr from a clone, if you'd rather see what you're running:\n\n```sh\ngit clone https://github.com/pehqge/macconvert.git\ncd macconvert \u0026\u0026 ./install.sh\n```\n\nSetup opens an interactive picker where you choose which Quick Actions you\nwant, and it only installs the dependencies for what you picked. If you skip\neverything video-related, ffmpeg never touches your disk.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo.gif\" alt=\"macconvert menu: interactive picker for enabling and disabling Quick Actions\" width=\"760\"\u003e\n\u003c/p\u003e\n\n## What you get\n\n| File type | Converts to |\n|---|---|\n| **Image** | PNG · JPG · WebP · HEIC · TIFF · GIF · AVIF · ICO · ICNS · PDF (multi-select combines into one) |\n| **Video** | MP4 (H.264) · MP4 (HEVC, hardware-accelerated) · MOV · WebM · MKV · animated GIF · extract MP3/M4A/WAV · compress |\n| **Audio** | MP3 · WAV · FLAC · M4A · OGG · OPUS |\n| **PDF** | PNG/JPG per page · text · DOCX · compress |\n| **Document** | DOCX ⇄ PDF/Markdown/HTML · Markdown ⇄ PDF/DOCX/HTML · HTML ⇄ Markdown/PDF · XLSX → PDF · PPTX → PDF |\n| **Ebook** | EPUB → MOBI/PDF · MOBI → EPUB · **Send to Kindle** |\n\nThe menu only shows conversions that make sense for the file you clicked.\nMulti-select works: grab fifty photos, run one action, done. And nothing is\never overwritten; if `photo.png` already exists you get `photo (1).png`.\n\n## Manage it anytime\n\n```sh\nmacconvert            # interactive menu\nmacconvert menu       # enable/disable any subset of actions\nmacconvert doctor     # health check\nmacconvert update     # update to the latest release\nmacconvert uninstall  # remove everything cleanly\n```\n\nPrefer not to think about updates? `macconvert autoupdate on` sets up a\nweekly background check.\n\n## Send to Kindle\n\nAn opt-in action that emails PDFs, EPUBs and documents straight to your\nKindle. `macconvert kindle setup` walks you through the three pieces:\n\n1. your `@kindle.com` address,\n2. the email account that does the sending (Gmail, iCloud or Outlook app\n   password; the password goes in the macOS Keychain, not in a file, and\n   existing Calibre settings import in one step),\n3. authorizing that sender on Amazon: [amazon.com/sendtokindle/email](https://www.amazon.com/sendtokindle/email)\n   → **Approved Personal Document E-mail List** → add the sender address.\n\nThen `macconvert kindle test` sends a test document to confirm the chain\nworks. Delivery goes through the system's `curl`, so there's nothing extra to\ninstall.\n\n## How it works\n\nEach action is a real macOS Service: a `.workflow` bundle generated\nprogrammatically into `~/Library/Services`, scoped to Finder by file type\n(UTI). The bundles call zsh scripts installed under\n`~/Library/Application Support/MacConvert`, which means you can delete the\ncloned repo after installing and everything keeps working.\n\nFailures notify you and point at `~/Library/Logs/macconvert/\u003caction\u003e.log`\nwith the exact tool error. Successes stay silent, because the new file\nshowing up next to the original is feedback enough. Nothing runs with\nelevated privileges.\n\nEvery conversion is covered by an end-to-end test\n([`tests/verify.sh`](tests/verify.sh)) that drives the installed bundles\nthrough the same `automator` path Finder uses.\n\n## Troubleshooting\n\n- **Actions missing from the menu:** run `macconvert doctor`, then restart\n  Finder with `killall Finder`. Still missing? Check System Settings →\n  Privacy \u0026 Security → Extensions → Finder.\n- **A conversion fails:** the notification points at the action's log, which\n  has the exact stderr from the underlying tool.\n\n## Contributing\n\nA new conversion takes one script and one manifest row. See\n[CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpehqge%2Fmacconvert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpehqge%2Fmacconvert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpehqge%2Fmacconvert/lists"}