RhythmBox

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #claude-code #cli #windows #codex #developer-tools #dsh

★ 113 Open GitHub ↗

A Rhythm Box System for your iOS app written in Swift. 🎵

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RhythmBox
A **Rhythm Box** System for your iOS app 🎵. The easiest way to create **Music Rhythm Patterns** in Swift.

[![BuddyBuild](https://dashboard.buddybuild.com/api/statusImage?appID=589332f8c8fcc401007586ce&branch=master&build=latest)](https://dashboard.buddybuild.com/apps/589332f8c8fcc401007586ce/build/latest?branch=master)
[![Version](https://img.shields.io/cocoapods/v/RhythmBox.svg?style=flat)](http://cocoapods.org/pods/RhythmBox)
[![License](https://img.shields.io/cocoapods/l/RhythmBox.svg?style=flat)](http://cocoapods.org/pods/RhythmBox)
[![Platform](https://img.shields.io/cocoapods/p/RhythmBox.svg?style=flat)](http://cocoapods.org/pods/RhythmBox)
[![Language](https://img.shields.io/badge/language-swift-oragne.svg?style=flat)](https://developer.apple.com/swift)

## What can I do with RhythmBox?
- [x] Generate a BPM or RPM Tempo
- [x] Select the Time Signature
- [x] Create a Rhythm pattern

## Demo Project

To run the example project, clone the repo, and run `pod install` from the Example directory first.

## Getting Started

### Requirements

- iOS 8.0+ / tvOS 9.0+
- Xcode 8.0+
- Swift 3.0+

### Installation with CocoaPods

[CocoaPods](cocoapods.org) is a 3rd-party dependency manager for Swift and Objective-C projects. For more information, refer to the [CocoaPods Getting Started Guide](https://guides.cocoapods.org/using/getting-started.html). Otherwise, you can install CocoaPods with the following command:

```bash
$ gem install cocoapods
```

#### Podfile
To integrate RhythmBox into your Xcode project using CocoaPods, specify it in your `Podfile`:

```ruby
source 'https://github.com/CocoaPods/Specs.git'
pod 'RhythmBox'
```

Then, run the following command:

```bash
$ pod install
```

###  Installation Manually
To integrate RhythmBox into your Xcode project manually, just include the filest from [/Pod/Classes/](https://github.com/manuelescrig/RhythmBox/tree/master/RhythmBox/Classes) folder in your App’s Xcode project.

## Quick Guide

### Usage

To Generate a constant BPM signal is as simple as this.

###### 1. Import class

```swift
import RhythmBox
```

###### 2. Create a RhythmBox class

```swift
let rhythmBox = RhythmBox(bpm: 120, timeSignature: (4,4))

```

###### 3. Start the Rhythm

```swift
rhythmBox.perform {CurrentBeat, CurrentSubBeat, CurrentNote in

print("CurrentBeat", CurrentBeat)
    print("CurrentSubBeat", CurrentSubBeat)
    print("CurrentNote", CurrentNote)

return .resume
}

```

###### 4. Stop the Rhythm

```swift
rhythmBox.stop()

```

### Examples

###### Example 1

Create a 120 BPM signal with a block.

```swift

let rhythmBox = RhythmBox(bpm: 120)
rhythmBox.perform {CurrentBeat, CurrentSubBeat, CurrentNote in

print("CurrentBeat", CurrentBeat)
    return .resume
}

```

###### Example 2
Create a 150 BPM signal with a time signature of 6/8 with default subdivision of <img src="https://github.com/manuelescrig/RhythmBox/blob/master/Resources/1.png" height="50">

```swift

let rhythmBox = RhythmBox(bpm: 150, timeSignature: (6,8))
rhythmBox.perform {CurrentBeat, CurrentSubBeat, CurrentNote in