{"id":13584085,"url":"https://github.com/sveinbjornt/hear","last_synced_at":"2026-04-30T01:02:21.414Z","repository":{"id":43082145,"uuid":"462903983","full_name":"sveinbjornt/hear","owner":"sveinbjornt","description":"Command line speech recognition and transcription for macOS","archived":false,"fork":false,"pushed_at":"2024-10-24T16:07:18.000Z","size":566,"stargazers_count":450,"open_issues_count":8,"forks_count":26,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-01T09:31:49.218Z","etag":null,"topics":["command-line","command-line-tool","macos","speech-recognition","transcribe-audio-files","transcription"],"latest_commit_sha":null,"homepage":"https://sveinbjorn.org/hear","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sveinbjornt.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://paypal.me/sveinbjornt","sveinbjorn.org/donations"]}},"created_at":"2022-02-23T21:00:13.000Z","updated_at":"2025-03-26T18:59:29.000Z","dependencies_parsed_at":"2024-10-24T14:20:09.781Z","dependency_job_id":"2cdee197-f312-4a35-b8ba-9c39791d93d3","html_url":"https://github.com/sveinbjornt/hear","commit_stats":{"total_commits":64,"total_committers":4,"mean_commits":16.0,"dds":0.046875,"last_synced_commit":"176a54adab917d270152ce0dffc1bc30a3e14450"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sveinbjornt%2Fhear","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sveinbjornt%2Fhear/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sveinbjornt%2Fhear/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sveinbjornt%2Fhear/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sveinbjornt","download_url":"https://codeload.github.com/sveinbjornt/hear/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247829491,"owners_count":21002995,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["command-line","command-line-tool","macos","speech-recognition","transcribe-audio-files","transcription"],"created_at":"2024-08-01T15:04:00.046Z","updated_at":"2026-04-30T01:02:21.385Z","avatar_url":"https://github.com/sveinbjornt.png","language":"Objective-C","funding_links":["https://paypal.me/sveinbjornt","sveinbjorn.org/donations","https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=BDT58J7HYKAEE"],"categories":["Objective-C"],"sub_categories":[],"readme":"[![macOS](https://img.shields.io/badge/macOS-000000?style=flat\u0026logo=apple\u0026logoColor=white)](https://en.wikipedia.org/wiki/MacOS)\n[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)\n[![Language](https://img.shields.io/badge/language-objective--c-lightgrey)](https://en.wikipedia.org/wiki/Objective-C)\n[![Release](https://shields.io/github/v/release/sveinbjornt/hear?display_name=tag)](https://github.com/sveinbjornt/hear/releases)\n[![Build](https://github.com/sveinbjornt/hear/actions/workflows/macos.yml/badge.svg)](https://github.com/sveinbjornt/hear/actions)\n\n# hear\n\n\u003cimg src=\"icon.png\" width=\"168\" height=\"168\" alt=\"hear\" style=\"float: right; margin-left: 20px; margin-bottom: 20px;\" align=\"right\"\u003e\n\n### macOS speech recognition via the command line\n\n`hear` is a command line interface for the built-in speech recognition capabilities\nin macOS. This makes it possible to transcribe spoken audio input or entire audio files.\n\nApple's macOS has long shipped with the `say` tool, a command line interface\nfor the operating system's venerable speech synthesis capabilities. As of\n10.15 \"Catalina\", it also ships with highly capable speech recognition for a variety\nof languages. This project is an attempt to provide a robust native CLI for this\nfunctionality since no such tool is provided by Apple. `hear` supports speech recognition\nand transcription of both live microphone input and audio files in a variety of formats.\nAll formats supported by CoreAudio should work (e.g. WAV, MP3, AIFF, AAC, CAF, ALAC, etc.).\n\nSee the [man page](https://sveinbjorn.org/files/manpages/hear.1.html) for further details.\n\n## Download\n\n\u003ca href=\"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=BDT58J7HYKAEE\"\u003e\u003cimg align=\"right\" src=\"https://www.paypalobjects.com/WEBSCR-640-20110306-1/en_US/i/btn/btn_donate_LG.gif\" \u003e\u003c/a\u003e\n\n`hear` is free, open source software written in Objective-C. The source code is freely\n[available](https://github.com/sveinbjornt/hear) under a [BSD license](#bsd-license).\n**If you find this program useful, please [make a donation](https://sveinbjorn.org/donations).**\n\n* **[⬇ Download hear 0.8](https://sveinbjorn.org/files/software/hear.zip)**\n(~50 KB, ARM/Intel 64-bit, macOS 13 or later, Developer ID signed and notarized by Apple)\n\n## Installation\n\nAfter downloading and expanding the archive, change to the resulting directory and run\nthe following command:\n\n```bash\nsudo bash install.sh\n```\n\nBy default, this will install the binary into `/usr/local/bin` and the \nman page into `/usr/local/share/man/man1/`.\n\n### Install via Homebrew\n\nA full installation of [Xcode](https://developer.apple.com/xcode/resources/) is required\nto build `hear` via Homebrew.\n\n```bash\nbrew tap sveinbjornt/hear https://github.com/sveinbjornt/hear\nbrew install sveinbjornt/hear/hear\n```\n\n## Usage\n\n### Transcribe audio from microphone (or default audio input device)\n\n```bash\nhear\n```\n\n### From microphone in single line output mode\n\n```bash\nhear -m\n```\n\n### Transcribe audio file\n\n```bash\nhear -d -i /path/to/someone_speaking.wav \u003e transcribed_text.txt\n```\n\nThe `-d` flag specifies that only on-device speech recognition capabilities\nshould be used. Otherwise, data may be sent to Apple servers, which as of\nwriting (2026) have a hard limit of about 500 characters before quitting.\n\nFor some reason, only those locales supported by Siri work with the `-d` flag.\n\n## Build\n\nTo build `hear` from source, run the following command from the repository root\n(requires Xcode command line build tools):\n\n```bash\nmake build_unsigned\n```\n\nThe resulting binary is created in `products/`.\n\n## Test\n\nTo run tests on the built command line tool, execute the following command\nfrom the repository root:\n\n```bash\nbash test/test.sh\n```\n\n## Troubleshooting\n\nIf running the binary leads to an abort signal, try running it by\nright-clicking it in the Finder and selecting Open. This should automatically\nopen the binary with your terminal client and prompt you to grant the required\npermissions.\n\n## BSD License\n\nCopyright (c) 2022-2026 [Sveinbjorn Thordarson](mailto:sveinbjorn@sveinbjorn.org)\n\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice, this\nlist of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice, this\nlist of conditions and the following disclaimer in the documentation and/or other\nmaterials provided with the distribution.\n\n3. Neither the name of the copyright holder nor the names of its contributors may\nbe used to endorse or promote products derived from this software without specific\nprior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.\nIN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,\nINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT\nNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,\nWHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)\nARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE\nPOSSIBILITY OF SUCH DAMAGE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsveinbjornt%2Fhear","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsveinbjornt%2Fhear","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsveinbjornt%2Fhear/lists"}