[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-7988":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":17,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":18,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":31,"discoverSource":32},7988,"coltrane","pedrozath\u002Fcoltrane","pedrozath","🎹🎸A music theory library with a command-line interface","",null,"Ruby",2396,69,20,10,0,2,6,62.74,"MIT License",false,"master",true,[25,26,27],"gem","music","ruby","2026-06-12 04:00:36","[![Build Status](https:\u002F\u002Ftravis-ci.org\u002Fpedrozath\u002Fcoltrane.svg?branch=master)](https:\u002F\u002Ftravis-ci.org\u002Fpedrozath\u002Fcoltrane)\n[![Gem Version](https:\u002F\u002Fbadge.fury.io\u002Frb\u002Fcoltrane.svg)](https:\u002F\u002Fbadge.fury.io\u002Frb\u002Fcoltrane)\n[![Maintainability](https:\u002F\u002Fapi.codeclimate.com\u002Fv1\u002Fbadges\u002Fe3c8171def8124132380\u002Fmaintainability)](https:\u002F\u002Fcodeclimate.com\u002Fgithub\u002Fpedrozath\u002Fcoltrane\u002Fmaintainability)\n[![Test Coverage](https:\u002F\u002Fapi.codeclimate.com\u002Fv1\u002Fbadges\u002Fe3c8171def8124132380\u002Ftest_coverage)](https:\u002F\u002Fcodeclimate.com\u002Fgithub\u002Fpedrozath\u002Fcoltrane\u002Ftest_coverage)\n\n# Coltrane\n\nA music calculation library\u002FCLI written in Ruby.\n\n![Coltrane](img\u002Fcoltrane-logo.png)\n\n## CLI (Command Line Interface)\n\n![Screenshot](img\u002Fusing-coltrane.gif)\n![Screenshot](img\u002Fguitar-chords.png)\n\n### Features\n\n* Generate chord progressions for Jazz, Blues, Pop, or custom and see how to play them\n* Seek chords, see their notes and how to play them\n* Seek scales, see their notes and see how to play them\n* Find chords that are common between 2 scales\n* Find scales containing a chord or a set of notes\n* Find possible progressions of a chord sequence\n* All of the above can be seen on guitar, bass, piano or ukelele representations, no sheet music needed\n\n\n### How to discover a chord name using the notes\n\n```sh\ncoltrane find chord by notes notes:C-E-G\n\nCM:  C E G\n\n```\n\nTo see it on guitar:\n\n```sh\ncoltrane show chord chord:CM7 chord_representation:Guitar\n\nCM:\n\n   ⬤    ⬤  ⬤   ⬤    ⬤  ⬤   ⬤    ⬤             ⬤  ⬤\n   ┍━┯━┯━┯━┯━┑    ┍━┯━┯━┯━┯━┑    ┍━┯━┯━┯━┯━┑    ┍━┯━┯━┯━┯━┑\n3  │ ⬤│ │ │ │ 8  │ │ │ │ ⬤│ 3  │ ⬤│ │ │ ⬤1  │ │ │ │ ⬤│\n   ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥\n4  │ │ │ │ │ │ 9  │ │ │ │ │ │ 4  │ │ │ │ │ │ 2  │ │ ⬤│ │ │\n   ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥\n5  │ │ ⬤│ ⬤│ 10 │ ⬤⬤│ │ │ 5  │ │ ⬤│ ⬤│ 3  ⬤⬤│ │ │ │\n   ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥    ┝━┿━┿━┿━┿━┥\n6  │ │ │ │ │ │ 11 │ │ │ │ │ │ 6  │ │ │ │ │ │ 4  │ │ │ │ │ │\n   ┕━┷━┷━┷━┷━┙    ┕━┷━┷━┷━┷━┙    ┕━┷━┷━┷━┷━┙    ┕━┷━┷━┷━┷━┙\n```\n\nPS: It looks way better on the terminal 😒, specially on [iTerm](http:\u002F\u002Fiterm2.com)\n\n### How to discover a Scale by providing chords\n\nYou shall provide chords separated by dashes (`--chords CM7-Dm7-EM`) or notes (`--notes C-Ab-F-G`).\n\n\nFor example:\n\n```sh\ncoltrane find scale by chords chords:E6\u002F9-BM\n\nPentatonic Major C(1) C#(3) D(3) D#(1) E(5) F(0) F#(4) G(2) G#(2) A(4) A#(0) B(5)\nBlues Major      C(2) C#(4) D(3) D#(2) E(5) F(1) F#(4) G(2) G#(3) A(4) A#(1) B(5)\nHarmonic Minor   C(3) C#(5) D(2) D#(4) E(4) F(3) F#(4) G(2) G#(5) A(3) A#(3) B(4)\nHungarian Minor  C(2) C#(6) D(2) D#(4) E(3) F(3) F#(5) G(1) G#(5) A(3) A#(4) B(4)\nPentatonic Minor C(1) C#(5) D(0) D#(4) E(2) F(2) F#(4) G(0) G#(5) A(1) A#(3) B(3)\nBlues Minor      C(2) C#(5) D(1) D#(4) E(2) F(3) F#(4) G(1) G#(5) A(2) A#(4) B(3)\nWhole Tone       C(3) C#(3) D(3) D#(3) E(3) F(3) F#(3) G(3) G#(3) A(3) A#(3) B(3)\nFlamenco         C(3) C#(4) D(2) D#(5) E(3) F(3) F#(4) G(3) G#(5) A(2) A#(4) B(4)\nMajor            C(2) C#(4) D(4) D#(2) E(6) F(1) F#(5) G(3) G#(3) A(5) A#(1) B(6)\nNatural Minor    C(2) C#(6) D(1) D#(5) E(3) F(3) F#(5) G(1) G#(6) A(2) A#(4) B(4)\n```\n\nWhen on terminal, the command above will highlight the Scales that have all needed notes. The number in the parenthesis show how many chord notes were included.\n\n### How to find common chords\n\nYou may use this command to find a chord that may serve as bridge to a different scale\u002Fkey (i.e. modulation). Coltrane offers you a command to find common chords shared between both keys\u002Fscales. Here is how you use it. Say you wanna transition from C Major to D Natural Minor.\n\n```sh\ncoltrane find common chords in scales\n\nDm:  D F A\nAm:  A C E\nDm7: D F A C\nAm7: A C E G\nCM:  C E G\nFM:  F A C\nCM6: C E G A\nFM6: F A C D\nC6\u002F9: C E G A D\nF6\u002F9: F A C D G\nC6\u002F9(add11): C E G A D F\n[...]\n```\n\nYou can also see the output in a graphical representation:\n\n```sh\nDm:\n\n┌─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─╥─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─┐\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ ║ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ │\n│  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  │\n│  ║D♮║  ║F♮║  ║A♮║  ║  ║D♮║  ║F♮║  ║A♮║  │\n└──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──┘\n\nAm:\n\n┌─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─╥─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─┐\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ ║ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ │\n│  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  │\n│C♮║  ║E♮║  ║  ║A♮║  ║C♮║  ║E♮║  ║  ║A♮║  │\n└──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──┘\n\n[...]\n```\n\n### Quickly generate chord progressions\n\n```sh\ncoltrane show progression progression:Jazz representation:Piano root:A\n\nBm7: \n\n┌─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─╥─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─┐\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ │ ││ │ ║ │F││ ││ │ ║ │ ││ │ ║ │F││ ││ │ │\n│ │ ││ │ ║ │♯││ ││ │ ║ │ ││ │ ║ │♯││ ││ │ │\n│ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ ║ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ │\n│  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  │\n│  ║D ║  ║  ║  ║A ║B ║  ║D ║  ║  ║  ║A ║B │\n└──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──┘\n\nE7: \n\n┌─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─╥─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─┐\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ │ ││ │ ║ │ ││G││ │ ║ │ ││ │ ║ │ ││G││ │ │\n│ │ ││ │ ║ │ ││♯││ │ ║ │ ││ │ ║ │ ││♯││ │ │\n│ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ ║ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ │\n│  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  │\n│  ║D ║E ║  ║  ║  ║B ║  ║D ║E ║  ║  ║  ║B │\n└──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──┘\n\nA7: \n\n┌─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─╥─┬─┬┬─┬─╥─┬─┬┬─┬┬─┬─┐\n│ │ ││ │ ║ │ ││ ││ │ ║ │ ││ │ ║ │ ││ ││ │ │\n│ │C││ │ ║ │ ││ ││ │ ║ │C││ │ ║ │ ││ ││ │ │\n│ │♯││ │ ║ │ ││ ││ │ ║ │♯││ │ ║ │ ││ ││ │ │\n│ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ ║ ┕╥┙┕╥┙ ║ ┕╥┙┕╥┙┕╥┙ │\n│  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  ║  │\n│  ║  ║E ║  ║G ║A ║  ║  ║  ║E ║  ║G ║A ║  │\n└──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──╨──┘\n```\n\nYou can say Jazz, Pop, Blues, etc.\nYou can also generate progressions in a custom way, using roman numerals:\n\n```sh\ncoltrane custom progression progression_notation:I-vi-V-iidim representation:Text key:D\n```\n\n### Generate fretboard sheets for improvising\n\nSometimes you wanna see the scale on guitar for improvising:\n\n```sh\n\ncoltrane show scale scale:Pentatonic-Major tone:F\n\nF Pentatonic Major:\n\nE -- | F  -- G  -- A  -- -- C  -- D  -- -- F  -- G  -- A  -- -- C  -- D  --\nA A  | -- -- C  -- D  -- -- F  -- G  -- A  -- -- C  -- D  -- -- F  -- G  --\nD D  | -- -- F  -- G  -- A  -- -- C  -- D  -- -- F  -- G  -- A  -- -- C  --\nG G  | -- A  -- -- C  -- D  -- -- F  -- G  -- A  -- -- C  -- D  -- -- F  --\nB -- | C  -- D  -- -- F  -- G  -- A  -- -- C  -- D  -- -- F  -- G  -- A  --\nE -- | F  -- G  -- A  -- -- C  -- D  -- -- F  -- G  -- A  -- -- C  -- D  --\n\n             03    05    07    09       12       15    17    19\n```\n\nProTip: You can force the guitar frets visualization for chords too using the `--on guitar_frets` option.\n\n### Finding the progression of a chord sequence\n\nPerhaps this is the most complex operation that Coltrane performs. It searches the chords on all known scales, generates the progression notation and print in, sorted by notes left out. That is because most songs, specially knowadays, may use chords that contain notes which are outside of that scale.\n\nThis command us to analyze songs and discover what they have in common, even tho they have different notes.\n\nLet's say we want to find the possible progressions of Red Hot Chili Pepper's Otherside:\n\n```sh\ncoltrane find progressions from chords chords:Am-F-C-G\n\ni-VI-III-VII   in A Natural Minor (0 notes out)\nvi-IV-I-V      in C Major (0 notes out)\niii-I-V-II     in F Major (1 notes out)\nvi-III-VII-IV  in D Hungarian Minor (1 notes out)\nv-III-VII-IV   in D Natural Minor (1 notes out)\nii-VII-IV-I    in G Hungarian Minor (2 notes out)\nii-VII-IV-I    in G Natural Minor (2 notes out)\nvii-V-II-VI    in A# Major (2 notes out)\niv-II-V-III    in D Pentatonic Minor (2 notes out)\nv-II-VI-III    in D Blues Minor (2 notes out)\niii-I-IV-II    in F Pentatonic Major (2 notes out)\niv-I-V-II      in F Blues Major (2 notes out)\n```\n\nPS: Notice that vi-IV-I-V is the well known I-V-vi-IV progression, [used in a lot of songs](http:\u002F\u002Fwww.wikiwand.com\u002Fen\u002FList_of_songs_containing_the_I–V–vi–IV_progression).\n\n### Interactive mode (shell)\n\nSimply type `coltrane` or `coltrane shell` to enable interactive mode. You can then run commands without typing `coltrane ` before, E.G.: `scale D harmonic minor`\n\n## Installation\nInstallation is done through the [RubyGems](https:\u002F\u002Frubygems.org\u002F) package manager:\n\n```bash\ngem install coltrane\n```\n> [!NOTE]\n> RubyGems comes packaged with the standard Ruby installation. You can find instructions on how to install Ruby [here](https:\u002F\u002Fwww.ruby-lang.org\u002Fen\u002Fdocumentation\u002Finstallation\u002F).\n\nOnce you install the gem, the CLI is installed in your system and it's ready to be used.\n\n## Any questions? Feature requests? Bugs?\n\n1. Find me on [Twitter](https:\u002F\u002Ftwitter.com\u002Fpedrozath). I'll be glad to answer.\n2. Open an issue.\n3. Join [our chatroom](http:\u002F\u002Fcoltrane-ruby.herokuapp.com\u002F)\n\n## Extra\n\n* [How to use the Core Theory library](https:\u002F\u002Fgithub.com\u002Fpedrozath\u002Fcoltrane\u002Fwiki\u002FCore-music-theory-library).\n* [Why did I write this library](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20170714063625\u002Fhttps:\u002F\u002Fmedium.com\u002F@pedrozath\u002Fso-i-wrote-a-library-to-help-me-compose-music-ddb4ae7c8227)\n* [See the changelog](CHANGELOG.md)\n\n## Contributing\n\n### How to contribute\n1. Fork this code\n2. Install the test suite (RSpec) by running good old `bundle` command\n3. Make your changes and maybe write a test or two.\n4. Check if specs pass `bundle exec rspec spec`\n5. Submit a PR.\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](http:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT).\n\nby Pedro Maciel | [twitter](http:\u002F\u002Ftwitter.com\u002Fpedrozath) | pedro@pedromaciel.com\n","Coltrane 是一个用 Ruby 编写的音乐理论库，同时提供命令行界面。其核心功能包括生成和弦进程、查找和弦和音阶及其在不同乐器上的演奏方法，并支持多种音乐风格如爵士、蓝调和流行等。项目还具备寻找两个音阶间共通和弦、根据给定和弦或音符集查找适用音阶等功能，且所有操作均可通过吉他、贝斯、钢琴或尤克里里等乐器的图形表示来展示结果，无需乐谱知识。适用于音乐创作者、学习者以及任何对音乐理论感兴趣的人士。","2026-06-11 03:15:31","top_language"]