{"id":22138584,"url":"https://github.com/lukafilipxvic/pyzam","last_synced_at":"2025-09-02T06:33:12.920Z","repository":{"id":230694699,"uuid":"656994814","full_name":"lukafilipxvic/Pyzam","owner":"lukafilipxvic","description":"Recognize and Visualise Songs in Your CLI","archived":false,"fork":false,"pushed_at":"2025-06-12T10:54:02.000Z","size":199754,"stargazers_count":69,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-02T06:32:40.821Z","etag":null,"topics":["cli","music","music-recognition","python","pyzam","shazam"],"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/lukafilipxvic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2023-06-22T04:57:03.000Z","updated_at":"2025-08-09T19:09:36.000Z","dependencies_parsed_at":"2024-04-02T05:22:05.182Z","dependency_job_id":"aebfd927-69d7-4470-a5cc-7a9dc4898a8e","html_url":"https://github.com/lukafilipxvic/Pyzam","commit_stats":null,"previous_names":["lukafilipxvic/pyzam"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/lukafilipxvic/Pyzam","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukafilipxvic%2FPyzam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukafilipxvic%2FPyzam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukafilipxvic%2FPyzam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukafilipxvic%2FPyzam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lukafilipxvic","download_url":"https://codeload.github.com/lukafilipxvic/Pyzam/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukafilipxvic%2FPyzam/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273244306,"owners_count":25070958,"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","status":"online","status_checked_at":"2025-09-02T02:00:09.530Z","response_time":77,"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":["cli","music","music-recognition","python","pyzam","shazam"],"created_at":"2024-12-01T20:10:46.030Z","updated_at":"2025-09-02T06:33:12.905Z","avatar_url":"https://github.com/lukafilipxvic.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr /\u003e\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"https://github.com/lukafilipxvic/pyzam/blob/main/images/pyzam-logo-dark.png?raw=true#gh-light-mode-only\" alt=\"Pyzam logo\" width=\"459\"\u003e\r\n\u003cimg src=\"https://github.com/lukafilipxvic/pyzam/blob/main/images/pyzam-logo-light.png?raw=true#gh-dark-mode-only\" alt=\"Pyzam logo\" width=\"459\"\u003e\r\n\u003c/p\u003e\r\n\u003cbr /\u003e\r\n\u003cbr /\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"./LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\"\u003e\u003c/a\u003e\r\n  \u003ca href=\"https://pypi.org/project/pyzam/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/pyzam.svg\"\u003e\u003c/a\u003e\r\n  \u003cimg src=\"https://pepy.tech/badge/pyzam\" alt=\"https://pepy.tech/project/pyzam\"\u003e\r\n  \u003cimg src=\"https://pepy.tech/badge/pyzam/month\" alt=\"https://pepy.tech/project/pyzam\"\u003e  \r\n\u003c/p\u003e\r\n\r\nPyzam is a free CLI music recognition tool for audio and mixtapes in Python.\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003cimg src=\"https://github.com/lukafilipxvic/pyzam/blob/main/images/pyzam-usage.gif\" alt=\"Pyzam usage\", width\"459\"\u003e\r\n\u003c/p\u003e\r\n\r\n## Installation\r\n\r\n### Dependencies\r\nPyzam requires [ffmpeg](https://git.ffmpeg.org/ffmpeg.git 'Download ffmpeg') installed.\r\n\r\n### Installation\r\nUsing uv (recommended):\r\n```bash\r\nuv tool run pyzam --speaker\r\n```\r\n\r\nUsing pip:\r\n```bash\r\n$ pip install pyzam\r\n```\r\n\r\nUsing environment.yml with Conda (installs ffmpeg for you):\r\n```\r\nconda env create -n pyzam --file=environment.yml\r\n\r\nconda activate pyzam\r\n```\r\n\r\n## Usage\r\nUsing uv:\r\n```bash\r\nuv tool run pyzam --speaker\r\n```\r\nUsing pip:\r\n```bash\r\n# Listen to speaker (5 seconds by default)\r\npyzam --speaker\r\n\r\n# Listen to microphone\r\npyzam --microphone\r\n\r\n# Listen to audio files\r\npyzam --input audio_file.mp3\r\n\r\n# Listen to audio via URL\r\npyzam --url \"https://archive.org/download/09-hold-me-in-your-arms/02%20-%20Never%20Gonna%20Give%20You%20Up.mp3\"\r\n```\r\n\r\n```bash\r\n# Loop the recognition continously and save the logs as CSV file\r\npyzam --speaker -d 10 --write --loop\r\n\r\n# Listen to mixtapes and save the logs as CSV file\r\npyzam --input audio_file.mp3 --duration 12 --mixtape\r\n```\r\n\r\nSee `pyzam --help` for more options.\r\n\r\n## Options\r\n| Argument name     | Description                                          |\r\n| ----------------  | -----------------------------------------------------|\r\n| --input           | Detects from the given audio input file.\r\n| --microphone, -m  | Listens to the microphone of your device.\r\n| --speaker, -s     | Listens to the speaker of your device (default).\r\n| --url, -u         | Detects from the given URL to an audio file.\r\n| --help, -h        | Show usage, options and exit.\r\n| --duration, -d    | Length of microphone or speaker recording. Max = 12 seconds.\r\n| --quiet, -q       | Supresses the operation messages (i.e. Recording speaker for X seconds...). \r\n| --loop, -l        | Loop the recognition process indefinitely.\r\n| --mixtape         | Detects every -d seconds for a given input file, only works with --input. --write is enabled automatically.\r\n| --json, -j        | Return the whole Shazamio output in JSON.\r\n| --write, -w       | Writes the output of as a CSV file.\r\n\r\n\r\n## Known Limitations\r\n### Shazam API Call Limit (Error 429)\r\nShazam allows up to 20 requests per minute. Hence, a proxy is recommended to speed up recognition when using ```--mixtape```.\r\n\r\n### 12 Second Duration Limit per request\r\nThe maximum sample duration that Shazam allows is 12 seconds. Any audio after 12 seconds will not be recieved by Shazam. \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flukafilipxvic%2Fpyzam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flukafilipxvic%2Fpyzam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flukafilipxvic%2Fpyzam/lists"}