{"id":13861429,"url":"https://github.com/yuma-m/pychord","last_synced_at":"2026-04-29T08:11:07.038Z","repository":{"id":7908754,"uuid":"56831251","full_name":"yuma-m/pychord","owner":"yuma-m","description":"Python library to handle musical chords.","archived":false,"fork":false,"pushed_at":"2026-03-04T11:53:34.000Z","size":235,"stargazers_count":287,"open_issues_count":15,"forks_count":50,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-03-04T18:38:24.439Z","etag":null,"topics":["chords","python-library"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/pychord","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/yuma-m.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,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2016-04-22T06:21:01.000Z","updated_at":"2026-03-04T11:53:38.000Z","dependencies_parsed_at":"2024-06-18T19:44:54.494Z","dependency_job_id":"14cb696f-ba2f-4444-a605-016f2e2fa897","html_url":"https://github.com/yuma-m/pychord","commit_stats":{"total_commits":162,"total_committers":10,"mean_commits":16.2,"dds":0.2407407407407407,"last_synced_commit":"44d3db5c075efdda4e7b4ecdb9cdef074b2aab0d"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/yuma-m/pychord","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuma-m%2Fpychord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuma-m%2Fpychord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuma-m%2Fpychord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuma-m%2Fpychord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yuma-m","download_url":"https://codeload.github.com/yuma-m/pychord/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuma-m%2Fpychord/sbom","scorecard":{"id":1243362,"data":{"date":"2026-01-26","repo":{"name":"github.com/yuma-m/pychord","commit":"24903b6b070739bcd405829330d8e365efd2ff3b"},"scorecard":{"version":"v5.4.1-0.20260130224013-ac18bf8aefea","commit":"ac18bf8aefea92d408c736bdd3d60fd8e59dc969"},"score":5.1,"checks":[{"name":"Code-Review","score":2,"reason":"Found 6/26 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#code-review"}},{"name":"Maintained","score":10,"reason":"15 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/codeql-analysis.yml:1","Warn: no topLevel permission defined: .github/workflows/deploy.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/yuma-m/pychord/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/yuma-m/pychord/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/yuma-m/pychord/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/yuma-m/pychord/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/yuma-m/pychord/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/yuma-m/pychord/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deploy.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/yuma-m/pychord/deploy.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deploy.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/yuma-m/pychord/deploy.yml/main?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/build.yml:25","Warn: pipCommand not pinned by hash: .github/workflows/build.yml:31","Warn: pipCommand not pinned by hash: .github/workflows/deploy.yml:19","Warn: pipCommand not pinned by hash: .github/workflows/deploy.yml:20","Info:   0 out of   8 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   4 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.2.2 not signed: https://api.github.com/repos/yuma-m/pychord/releases/135427016","Warn: release artifact v1.2.2 does not have provenance: https://api.github.com/repos/yuma-m/pychord/releases/135427016"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#branch-protection"}},{"name":"SAST","score":8,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 14 commits out of 25 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/ac18bf8aefea92d408c736bdd3d60fd8e59dc969/docs/checks.md#sast"}}]},"last_synced_at":"2026-02-14T10:39:11.222Z","repository_id":7908754,"created_at":"2026-02-14T10:39:11.222Z","updated_at":"2026-02-14T10:39:11.222Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32416254,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T06:29:02.080Z","status":"ssl_error","status_checked_at":"2026-04-29T06:29:00.631Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["chords","python-library"],"created_at":"2024-08-05T06:01:22.090Z","updated_at":"2026-04-29T08:11:07.033Z","avatar_url":"https://github.com/yuma-m.png","language":"Python","funding_links":[],"categories":["Python","Music Theory \u0026 Composition"],"sub_categories":["Text-to-Speech"],"readme":"![PyChord](https://github.com/yuma-m/pychord/raw/main/pychord.png)\n\n# PyChord ![Build Status](https://github.com/yuma-m/pychord/actions/workflows/build.yml/badge.svg) [![Documentation Status](https://readthedocs.org/projects/pychord/badge/?version=latest)](http://pychord.readthedocs.io/en/latest/?badge=latest)\n\n## Overview\n\nPyChord is a Python library to handle musical chords.\n\n## Installation\n\nPyChord supports Python 3.10 and above.\n\n```sh\n$ pip install pychord\n```\n\n## Basic Usage\n\n### Create a Chord\n\n```python\n\u003e\u003e\u003e from pychord import Chord\n\u003e\u003e\u003e c = Chord(\"Am7\")\n\u003e\u003e\u003e c\n\u003cChord: Am7\u003e\n\u003e\u003e\u003e c.info()\n\"\"\"\nAm7\nroot=A\nquality=m7\non=None\n\"\"\"\n```\n\n### Transpose a Chord\n\n```python\n\u003e\u003e\u003e c = Chord(\"Am7/G\")\n\u003e\u003e\u003e c.transpose(3)\n\u003e\u003e\u003e c\n\u003cChord: Cm7/Bb\u003e\n```\n\n### Get component notes\n\n```python\n\u003e\u003e\u003e c = Chord(\"Am7\")\n\u003e\u003e\u003e c.components()\n['A', 'C', 'E', 'G']\n\u003e\u003e\u003e c.components_with_pitch(root_pitch=3)\n['A3', 'C4', 'E4', 'G4']\n```\n\n### Compare Chords\n\n```python\n\u003e\u003e\u003e Chord(\"C\") == Chord(\"D\")\nFalse\n\u003e\u003e\u003e Chord(\"C#\") == Chord(\"Db\")\nTrue\n\u003e\u003e\u003e c = Chord(\"C\")\n\u003e\u003e\u003e c.transpose(2)\n\u003e\u003e\u003e c == Chord(\"D\")\nTrue\n```\n\n### Find Chords from notes\n\n```python\n\u003e\u003e\u003e from pychord import find_chords_from_notes\n\u003e\u003e\u003e find_chords_from_notes([\"C\", \"E\", \"G\"])\n[ \u003cChord: C\u003e]\n\u003e\u003e\u003e find_chords_from_notes([\"F#\", \"A\", \"C\", \"D\"])\n[ \u003cChord: D7/F#\u003e]\n\u003e\u003e\u003e find_chords_from_notes([\"F\", \"G\", \"C\"])\n[ \u003cChord: Fsus2\u003e, \u003cChord: Csus4/F\u003e]\n```\n\n### Create and handle chord progressions\n\n```python\n\u003e\u003e\u003e from pychord import ChordProgression\n\u003e\u003e\u003e cp = ChordProgression([\"C\", \"G/B\", \"Am\"])\n\u003e\u003e\u003e cp\n\u003cChordProgression: C | G/B | Am\u003e\n\n\u003e\u003e\u003e cp.append(\"Em/G\")\n\u003e\u003e\u003e cp\n\u003cChordProgression: C | G/B | Am | Em/G\u003e\n\n\u003e\u003e\u003e cp.transpose(+3)\n\u003e\u003e\u003e cp\n\u003cChordProgression: Eb | Bb/D | Cm | Gm/Bb\u003e\n\n\u003e\u003e\u003e cp[1]\n\u003cChord: Bb/D\u003e\n```\n\n## Advanced Usage\n\n### Create a Chord from note index in a scale\n\n```python\n\u003e\u003e\u003e Chord.from_note_index(note=1, quality=\"\", scale=\"Cmaj\")\n\u003cChord: C\u003e  # I of C major\n\u003e\u003e\u003e Chord.from_note_index(note=3, quality=\"m7\", scale=\"Fmaj\")\n\u003cChord: Am7\u003e  # IIIm7 of F major\n\u003e\u003e\u003e Chord.from_note_index(note=5, quality=\"7\", scale=\"Amin\")\n\u003cChord: E7\u003e  # V7 of A minor\n```\n\n### Overwrite the default Quality components with yours\n\n```python\n\u003e\u003e\u003e from pychord import Chord, QualityManager\n\u003e\u003e\u003e Chord(\"C11\").components()\n['C', 'E', 'G', 'Bb', 'D', 'F']\n\n\u003e\u003e\u003e quality_manager = QualityManager()\n\u003e\u003e\u003e quality_manager.set_quality(\"11\", (\"1\", \"3\", \"5\", \"b7\", \"11\"))\n\u003e\u003e\u003e Chord(\"C11\").components()\n['C', 'E', 'G', 'Bb', 'F']\n```\n\n### Inversions\n\nChord inversions are created with a forward slash and a number\nindicating the order. This can optionally be combined with an\nadditional forward slash to change the bass note:\n\n```python\n\u003e\u003e\u003e Chord(\"C/1\").components() # First inversion of C\n['E', 'G', 'C']\n\u003e\u003e\u003e Chord(\"C/2\").components() # Second inversion of C\n['G', 'C', 'E']\n\n\u003e\u003e\u003e Chord(\"Cm7/3/F\").components() # Third inversion of Cm7 with an added F bass\n['F', 'Bb', 'C', 'Eb', 'G']\n```\n\n## Examples\n\n- [pychord-midi.py](./examples/pychord-midi.py) - Create a MIDI file using PyChord and pretty_midi.\n\n## Links\n\n- [PyPI](https://pypi.python.org/pypi/pychord)\n- [GitHub](https://github.com/yuma-m/pychord)\n- [Documentation](http://pychord.readthedocs.io/en/latest/)\n\n## Author\n\n- [Yuma Mihira](https://yuma.cloud/)\n\n## License\n\n- MIT License\n\nThe logo is made from [Freepik](https://www.flaticon.com/authors/freepik).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuma-m%2Fpychord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuma-m%2Fpychord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuma-m%2Fpychord/lists"}