https://github.com/AudioKit/Tonic

Swift library for music theory
https://github.com/AudioKit/Tonic

chords intervals music scales theory

Last synced: 8 months ago
JSON representation

Swift library for music theory

• Host: GitHub
• URL: https://github.com/AudioKit/Tonic
• Owner: AudioKit
• License: mit
• Created: 2022-04-28T03:43:34.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-12-18T21:34:02.000Z (10 months ago)
• Last Synced: 2025-02-14T17:40:17.668Z (8 months ago)
• Topics: chords, intervals, music, scales, theory
• Language: Swift
• Homepage: https://www.audiokit.io/Tonic/
• Size: 1.15 MB
• Stars: 163
• Watchers: 13
• Forks: 22
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Tonic

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FAudioKit%2FTonic%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/AudioKit/Tonic)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FAudioKit%2FTonic%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/AudioKit/Tonic)



Swift library for music theory, currently focused on chords/harmony.

Tonic answers musical questions, such as:

- What's the note for this pitch in this key? 

    `Note(pitch: Pitch(midiNoteNumber), key: .Bb)`

- What's the name of a chord? 

    `Chord(notes: notes).description`

- What chords are in this key? 

    `Key.Cm.chords`

- What chords in this key contain this note? 

    `Key.C.chords.filter { $0.noteClasses.contains(.C) }`

- What notes do these keys have in common?  

    `Key.C.noteSet.intersection(Key.Cm.noteSet)`

- What notes don't these keys have in common? 

    `Key.C.noteSet.symmetricDifference(Key.Cm.noteSet)`

These questions are all tested in our unit tests explicitly.

## Goals

- **Correctness**. Try to be as correct with respect to music theory as possible.

- **Strong typing**. Use types to prevent errors (e.g. `Pitch` instead of `UInt8`).

- **Good performance**. Tonic uses bit sets to represent pitch sets and note sets.

## Documentation

The documentation is host on the [AudioKit.io Website](https://www.audiokit.io/Tonic/). The package includes a demo project as well.

## Install

Install using Swift Package Manager.