{"id":43455091,"url":"https://github.com/caleb531/youversion-suggest-alfred","last_synced_at":"2026-02-03T03:00:52.497Z","repository":{"id":14411284,"uuid":"17122119","full_name":"caleb531/youversion-suggest-alfred","owner":"caleb531","description":"An Alfred workflow for searching the YouVersion Bible quickly and easily","archived":false,"fork":false,"pushed_at":"2025-09-26T18:40:25.000Z","size":4138,"stargazers_count":61,"open_issues_count":0,"forks_count":1,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-09-26T20:40:35.092Z","etag":null,"topics":["alfred","alfred-workflow","bible","python","youversion"],"latest_commit_sha":null,"homepage":"","language":"Python","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/caleb531.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-02-24T01:47:18.000Z","updated_at":"2025-09-26T18:40:29.000Z","dependencies_parsed_at":"2024-01-27T23:20:50.959Z","dependency_job_id":"c7662744-fdcf-47b6-9454-0e8a7c17d521","html_url":"https://github.com/caleb531/youversion-suggest-alfred","commit_stats":null,"previous_names":[],"tags_count":97,"template":false,"template_full_name":null,"purl":"pkg:github/caleb531/youversion-suggest-alfred","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fyouversion-suggest-alfred","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fyouversion-suggest-alfred/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fyouversion-suggest-alfred/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fyouversion-suggest-alfred/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caleb531","download_url":"https://codeload.github.com/caleb531/youversion-suggest-alfred/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fyouversion-suggest-alfred/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29029760,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T02:28:16.591Z","status":"ssl_error","status_checked_at":"2026-02-03T02:27:48.904Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["alfred","alfred-workflow","bible","python","youversion"],"created_at":"2026-02-03T03:00:29.921Z","updated_at":"2026-02-03T03:00:52.478Z","avatar_url":"https://github.com/caleb531.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YouVersion Suggest for Alfred\n\n*Copyright 2014-2024 Caleb Evans*  \n*Released under the MIT license*\n\n[![tests](https://github.com/caleb531/youversion-suggest-alfred/actions/workflows/tests.yml/badge.svg)](https://github.com/caleb531/youversion-suggest-alfred/actions/workflows/tests.yml)\n[![Coverage Status](https://coveralls.io/repos/caleb531/youversion-suggest-alfred/badge.svg?branch=master)](https://coveralls.io/r/caleb531/youversion-suggest-alfred?branch=master)\n\nYouVersion Suggest is an [Alfred](https://www.alfredapp.com/) workflow which\nallows you to search the online [YouVersion](https://www.youversion.com/) Bible\nquickly and conveniently.\n\nThe workflow will be solely supporting Alfred 5.5 going forward, but the latest\nreleases for Alfred 4 and earlier will remain available here for your\nconvenience.\n\n## Disclaimer\n\nThis project is not affiliated with YouVersion, and all Bible content is\ncopyright of the respective publishers.\n\nThis tool also retrieves Bible content directly from YouVersion for personal\nuse. However, please be aware that this functionality does not fully comply with\nYouVersion's Terms of Use.\n\n## Installation\n\nTo download the workflow, simply click one of the download links below. Please\nnote that only the Alfred 5 version has all the latest features.\n\n[Download YouVersion Suggest (Alfred 5)][workflow-download-alfred5]\n\n[workflow-download-alfred5]: https://github.com/caleb531/youversion-suggest-alfred/raw/main/YouVersion%20Suggest%20(Alfred%205).alfredworkflow\n\n[Download YouVersion Suggest (Alfred 4)][workflow-download-alfred4]\n\n[workflow-download-alfred4]: https://github.com/caleb531/youversion-suggest-alfred/raw/main/YouVersion%20Suggest%20(Alfred%204).alfredworkflow\n\n### Command Line Tools\n\nIf you are installing the workflow for the first time, you may be prompted to\ninstall Apple's Command Line Tools. These developer tools are required\nfor the workflow to function, and fortunately, they have a much smaller size\nfootprint than full-blown Xcode.\n\n\u003cimg src=\"screenshot-clt-installer.png\" alt=\"Prompt to install Apple's Command Line Tools\" width=\"461\" /\u003e\n\n## Usage\n\n### Filtering by reference\n\nThe `yvfilter` keyword allows you to filter the YouVersion Bible by reference,\nmeaning you can jump to a particular Bible reference (book, chapter, verse, or\nrange of verses) with just a few keystrokes.\n\n**Pro Tip:** Type `yvf` and press the `tab` key to quickly filter by reference\n(as this will expand to `yvfilter`).\n\n#### Example queries\n\n- `yvfilter luke` =\u003e Luke\n- `yvfilter eph 3` =\u003e Ephesians 3\n- `yvfilter 1t3es` =\u003e 1 Thessalonians 3 (ESV), 1 Timothy 3 (ESV)\n- `yvfilter mat 6:34 nlt` =\u003e Matthew 6:34 (NLT)\n- `yvfilter 1 co 13.4-7` =\u003e 1 Corinthians 13:4-7\n\n![Filtering by reference](screenshot-yvfilter.png)\n\n#### Actions\n\n- Choosing a result will open the Bible reference on the YouVersion website\n\n- Choosing a result while pressing `command` will copy the contents of the Bible\nreference to the clipboard\n\n- Choosing a result while pressing `ctrl` will open a Google search for the\nBible reference.\n\n- Choosing a result while pressing `shift` will preview the contents of the\nBible reference; hitting the Escape key will return you to the results\n\n- Choosing a result while pressing `option` will copy the URL of the Bible\nreference to the clipboard\n\n- Choosing a `yvsearch` result while pressing `command-shift` will switch to\n  `yvfilter` to filter by that particular Bible reference. This allows you to\n  change the version or add on subsequent verses, after which you can then copy\n  the reference contents or perform some other action\n\n- Pressing `command-c` while a result is selected will copy to the clipboard the\nfull Bible reference address, such as *1 Corinthians 13:4-7 (ESV)*\n\n- Pressing `command-l` while a result is selected will show the full Bible\nreference address as Large Type\n\n### Searching by content\n\nYou can also search the YouVersion Bible by content using the `yvsearch`\nkeyword. As you type, YouVersion Suggest will display Bible verses whose content\ncontains your given keywords.\n\nNote that when using the `yvsearch` filter, YouVersion Suggest will only search\nfor verses in your preferred version. To learn more about setting your preferred\nversion in YouVersion Suggest, see *Setting your preferred version*.\n\n#### Example queries\n\n- `yvsearch without faith` =\u003e Hebrews 11:6\n- `yvsearch do not worry` =\u003e Matthew 6:34\n\n![Searching by content](screenshot-yvsearch.png)\n\n#### Actions\n\nYou can perform all the same actions on a result with `yvsearch` as you can with\n`yvfilter`.\n\n### Setting your preferred language\n\nYouVersion Suggest allows you to change the languages used for Bible references\nand versions. To do so, type `yvset language` into Alfred, and the list of\nsupported languages will then appear. You may then choose another language to be\nyour preferred language.\n\nCurrently, YouVersion Suggest supports the following languages:\n\n- Arabic (arb)\n- Bulgarian (bul)\n- Dutch (nld)\n- Chinese - Simplified (zho)\n- Chinese - Traditional (zho-TW)\n- English (eng)\n- Finnish (fin)\n- French (fra)\n- German (deu)\n- Hindi (hin)\n- Indonesian (ind)\n- Italian (ita)\n- Japanese (jpn)\n- Khmer (khm)\n- Korean (kor)\n- Persian (pes)\n- Polish (pol)\n- Portuguese (por)\n- Portuguese - Portugal (por-PT)\n- Romanian (ron)\n- Russian (rus)\n- Spanish (spa)\n- Spanish - Spain (spa-ES)\n- Swahili (swh)\n- Swedish (swe)\n- Ukrainian (ukr)\n- Vietnamese (vie)\n\n### Setting your preferred version\n\nYou may also set your preferred version (translation) used for Bible references\n(where you have not explicitly specified the version in the query). To do so,\ntype `yvset version` into Alfred, and the list of supported versions (for the\ncurrently-set language) will appear.\n\n**Pro Tip:** Type `yvset v` and press the `tab` key to quickly see the list of\navailable versions to set (as this will expand to `yvset version`).\n\nTo select a version from the list of versions more quickly, you may optionally\ntype a query after `yvset version` to filter the list of versions.\n\n#### Example queries\n\n- `yvset version esv` =\u003e ESV\n- `yvset version a` =\u003e AMP\n\n### Setting your preferred search engine\n\nYou may also set your preferred search engine used for searching selected Bible\nreferences. To do so, open the YouVersion Suggest workflow in Alfred Preferences\nand double-click the *Default Web Search* object. You can then choose a search\nengine to set as your preferred for YouVersion Suggest.\n\n### Showing verse numbers in copied Bible content\n\nYou can choose whether or not to include verse numbers in copied Bible verses by\ntyping `yvset versenumbers yes`.\n\n### Stripping line breaks in copied Bible content\n\nYou can choose whether or not to strip line breaks from copied Bible content, so\nthat the verses you copy appear all on one line (even if it's from a psalm, for\nexample). To do this, type `yvset linebreaks no`.\n\n### Making \"Copy to Clipboard\" the default action\n\nIf you would prefer to just press `Enter` (without holding down the `command`\nkey) to copy the content of a Bible reference, type `yvset copybydefault yes`.\nWhen this is enabled, you can still open the selected reference on the\nYouVersion website by holding down the `command` key.\n\n### Universal Actions\n\nVersion 15 of the workflow brings integration with Alfred's\n[Universal Actions][universal-actions] feature, enabling you to pass any\narbitrary text to the workflow when you select it within an app or on a webpage.\n\nTo use this, you must enable the **Workflow Universal Actions** checkbox in\nAlfred Preferences, under **Features \u003e Universal Actions \u003e Actions**.\n\nIn particularly, there are two universal actions available:\n\n1. Look up Bible address\n2. Search phrase in Bible\n\n[universal-actions]: https://www.alfredapp.com/help/features/universal-actions/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaleb531%2Fyouversion-suggest-alfred","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaleb531%2Fyouversion-suggest-alfred","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaleb531%2Fyouversion-suggest-alfred/lists"}