{"id":27197076,"url":"https://github.com/mk6i/flash-card-cli","last_synced_at":"2025-04-09T20:27:08.939Z","repository":{"id":68969239,"uuid":"117925714","full_name":"mk6i/flash-card-cli","owner":"mk6i","description":"Command-line audio flash cards for MacOS.","archived":false,"fork":false,"pushed_at":"2024-01-05T01:59:54.000Z","size":9,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-06-21T18:05:42.935Z","etag":null,"topics":["flash-cards","language-learning","self-improvement","self-study","study-aid","study-notes"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mk6i.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-01-18T03:16:21.000Z","updated_at":"2024-01-05T01:53:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"47774c2d-7b0e-4ec3-9c4d-28643bd0c5b9","html_url":"https://github.com/mk6i/flash-card-cli","commit_stats":null,"previous_names":["mk6i/flash-card-cli"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk6i%2Fflash-card-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk6i%2Fflash-card-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk6i%2Fflash-card-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk6i%2Fflash-card-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mk6i","download_url":"https://codeload.github.com/mk6i/flash-card-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248106033,"owners_count":21048663,"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":["flash-cards","language-learning","self-improvement","self-study","study-aid","study-notes"],"created_at":"2025-04-09T20:27:08.146Z","updated_at":"2025-04-09T20:27:08.852Z","avatar_url":"https://github.com/mk6i.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Flash Card CLI\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/2894330/35425631-36b7d03a-022a-11e8-83ae-93a8cbde1d45.gif\"\u003e\n\u003c/p\u003e\n\nFlash Card CLI is a command-line study aid for MacOS. It audibly outputs two-column CSV files in sequence using the built-in `say` command, pausing between entries until the user hits the enter key to continue.\n\nThis tool is useful for language learners because it can be configured to output words using foreign voices. For instance, the tool can speak English words in the left column using an English voice and French words in the other using a French voice.\n\n## Installation\n\nDownload the Flash Card CLI from the [releases page](https://github.com/mkaminski1988/flash-card-cli/releases) and move it to the `/usr/local/bin` directory. \n\nQuick install:\n\n```bash\ncurl -O \\\n-L https://github.com/mkaminski1988/flash-card-cli/releases/download/1.0/flash-macos \u0026\u0026 \\\nchmod +x flash-macos \u0026\u0026 \\\nsudo mv flash-macos /usr/local/bin/flash\n```\n\n## Usage\n\n#### Input File `vocab.csv`\n\n```csv\nnageoire (f),flipper\ndans le sens des aiguilles d’une montre,clockwise\nreculé,\"remote, distant\"\ncalotte polaire (f),polar ice cap\nvivres (nmpl),food supplies\n```\n\n\u003e The voice engine ignores notes written in `(parentheses)`.\n\nRead the left column using Thomas (a French voice) and the right column using Alex (an American English voice).\n\n```bash\ncat vocab.csv | flash -left Thomas -right Alex\n```\n\nThe `-reverse` flag tells the speaker to read the right column before the left column.\n\n```bash\ncat vocab.csv | flash -left Thomas -right Alex -reverse\n```\n\nMix it up! Improve retention and recall by randomly sorting multiple input files.\n\n```\ncat vocab_1.csv vocab_2.csv | sort -R | flash\n```\n\n#### Viewing available voices\n\nMacOS offers plenty of built-in voices for multiple languages. Run the following command to see which voices are available to pass to the `-left` and `-right` flags.\n\n```bash\nsay -v '?'\n```\n\n```bash\nAlex                en_US    # Most people recognize me by my voice.\nAlice               it_IT    # Salve, mi chiamo Alice e sono una voce italiana.\nAlva                sv_SE    # Hej, jag heter Alva. Jag är en svensk röst.\nAmelie              fr_CA    # Bonjour, je m’appelle Amelie. Je suis une voix canadienne.\nAnna                de_DE    # Hallo, ich heiße Anna und ich bin eine deutsche Stimme.\nCarmit              he_IL    # שלום. קוראים לי כרמית, ואני קול בשפה העברית.\nDamayanti           id_ID    # Halo, nama saya Damayanti. Saya berbahasa Indonesia.\n[..]\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmk6i%2Fflash-card-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmk6i%2Fflash-card-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmk6i%2Fflash-card-cli/lists"}