rosabeats 0.1.3__py3-none-any.whl

rosabeats-0.1.3.dist-info/METADATA

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: rosabeats
+Version: 0.1.3
+Summary: Audio beat detection, segmentation, and remixing library using librosa
+Author: John Fleming
+License-Expression: ISC
+Project-URL: Homepage, https://github.com/jbff/rosabeats
+Project-URL: Repository, https://github.com/jbff/rosabeats
+Keywords: audio,beat,detection,segmentation,remixing,librosa,music
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: librosa<1.0,>=0.11.0
+Requires-Dist: soundfile<1.0,>=0.13.0
+Requires-Dist: sounddevice<1.0,>=0.5.0
+Requires-Dist: numpy<3.0,>=2.0
+Requires-Dist: scipy<2.0,>=1.15
+Requires-Dist: scikit-learn<2.0,>=1.5
+Provides-Extra: ffms2
+Requires-Dist: ffms2; extra == "ffms2"
+Provides-Extra: vamp
+Requires-Dist: vamp; extra == "vamp"
+Provides-Extra: all
+Requires-Dist: ffms2; extra == "all"
+Requires-Dist: vamp; extra == "all"
+Dynamic: license-file
+
+# rosabeats
+
+This repository contains the rosabeats Python library that allows for audio beat detection, segmentation, and remixing. It leverages the power of librosa and other audio processing libraries to enable precise beat tracking, song segmentation, and creative audio manipulation. This repository contains the core library code and various tools including scripts to segment songs, create and play/save beat "recipes", and a command line interpreter for interactive beat manipulation.
+
+I wrote this because for some reason I was too dense to figure out how to use [Amen](https://github.com/algorithmic-music-exploration/amen) to replicate in Python something like the Infinite Jukebox. That was the initial impetus, anyway. This code is not elegant. If I was too dense to figure out how to use amen, even with the code and examples in front of me, you can bet that I did not write elegant code. But it does work and I have enjoyed playing with it.
+
+A short mp3 that is in the public domain is included and an example beat recipe that references it. The track used for this example was obtained from [Free Music Archive](https://freemusicarchive.org/music/play-house/single/random-drop/) - "Random Drop" by Play House - and is distributed under the Creative Commons Public Domain License (CC0), which allows for unrestricted use, modification, and distribution without any copyright restrictions. Many thanks to the creator.
+
+I wrote most of this code in 2018-2019 and made some additions through 2021. I created this public repo to hold the most useful bits on April 12, 2025. I intend to improve the code. It almost certainly contains bugs that I don't ever hit. It was cobbled together a feature at a time and thus, looks and probably acts that way.
+
+## Features
+
+- **Beat Detection**: Automatically detect beats and tempo in audio files
+- **Bar Analysis**: Group beats into bars with configurable beats-per-bar
+- **Audio Segmentation**: Segment songs into structural parts using:
+  - Laplacian segmentation (powered by librosa)
+  - Segmentino (using Vamp plugins) 
+- **Audio Remixing**: Create remixes by manipulating beats and bars:
+  - Play individual beats or ranges of beats
+  - Play entire bars or ranges of bars
+  - Shuffle beats or bars randomly
+  - Reverse the order of beats within bars
+  - Create precise rests with beat-accurate timing
+- **Beat Recipe Files**: Save and load beat patterns as reusable recipes
+- **Interactive Shell**: Command-line interface for experimenting with beat patterns
+- **Segment Analysis**: Identify structurally similar sections in songs
+- **Output Options**: Play remixes in real-time, save to files, or generate beat recipes
+
+## Installation
+
+### Prerequisites
+
+- Python 3.9+ (Tested most recently with Python 3.11.12 and 3.13.2)
+- ffms2 libraries (On Fedora: `dnf install ffms2`; tested most recently with ffms-5.0)
+
+### Installing from PyPI
+
+```bash
+# Basic install
+pip install rosabeats
+
+# With optional dependencies
+pip install rosabeats[all]
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+```bash
+uv pip install rosabeats
+uv pip install rosabeats[all]
+```
+
+### Installing from Source
+
+1. Clone the repository:
+```bash
+git clone https://github.com/jbff/rosabeats.git
+cd rosabeats
+```
+
+2. Install the package:
+```bash
+pip install .
+```
+
+Or for development (editable install):
+```bash
+pip install -e .
+```
+
+3. Installing optional dependencies:
+
+rosabeats has optional dependencies that can be installed based on your needs:
+
+```bash
+# Install with Vamp plugin support
+pip install .[vamp]
+
+# Install with ffms2 support for additional audio formats
+pip install .[ffms2]
+
+# Install with all optional dependencies
+pip install .[all]
+```
+
+This will install the package and its dependencies, and make the following command-line tools available:
+- `beatrecipe-processor`: Process beat recipes
+- `segment-song`: Segment songs using librosa's Laplacian segmentation
+- `beatswitch`: Generate beat recipes with alternating patterns
+- `rosabeats-shell`: Interactive shell for beat manipulation
+
+### Optional: Vamp Plugins for Segmentino
+
+If you want to use the Segmentino-based segmentation:
+
+1. Download and install the Vamp plugin SDK
+2. Install the Segmentino plugin
+
+### Using rosabeats
+
+The package can be imported in Python as:
+```python
+import rosabeats
+```
+
+Documentation for beat recipes can be found in the `docs/` directory of the package. The main tools (`beatrecipe_processor.py` and `segment_song.py`) have been tested and are functional. Additional scripts in the `scripts/` directory may be of interest but have not been recently tested.
+
+## License
+
+## ISC License
+
+Copyright © 2025 [John Fleming](https://github.com/jbff)
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+## Acknowledgments
+
+- [librosa](https://librosa.org/) for audio analysis
+- [Vamp plugins](https://www.vamp-plugins.org/) for audio segmentation
+- [Amen](https://github.com/algorithmic-music-exploration/amen) was the original inspiration
+

rosabeats-0.1.3.dist-info/RECORD

@@ -0,0 +1,16 @@
+docs/beatrecipe_docs.txt,sha256=2WOPDt_8Av27vKV5Sq2yYK0PhByJH4nU6JS6rnlD4PM,3355
+rosabeats/__init__.py,sha256=egpPGyTlEcFz8g4Fxlmzx3R2ntFXoVUc0ttzFOyPOFs,841
+rosabeats/beatrecipe_processor.py,sha256=fAMJugNVfYvEza2U3C4s488d9KT4LejvglAlBBTBjJk,16230
+rosabeats/beatswitch.py,sha256=VOO00lHM8TYrPHBL-a0SkJ5jvFtSUq6LpyID3WhZfZ8,8483
+rosabeats/rosabeats.py,sha256=BHYD01biiw3z-vtoGGs9gK-ZURk9velt6Or0_-Qom1c,36264
+rosabeats/rosabeats_shell.py,sha256=Giq1sdHw96TOK86ze5QUfnOuyKsFzddfWP5fTztJt4w,10718
+rosabeats/segment_song.py,sha256=VJ4poSXVfXZGFLkn8HP92M3bCjk-wMxeumBwAh2svec,6703
+rosabeats-0.1.3.dist-info/licenses/LICENSE.md,sha256=aPJeloE50MoONg47hPe8CtvglnNcGO3tsS-S5os4WiA,771
+scripts/reverse_beats_in_bars_rosa.py,sha256=g1fRRTTko7BrDnmGQOhIq_rMsVYQznUwgTolRSXFDpI,1167
+scripts/shuffle_bars_rosa.py,sha256=m3zLkQ8A0tgApeVUni6calh6xwHLwzJlkG_qdbyJ3bU,799
+scripts/shuffle_beats_rosa.py,sha256=USaHpWgv7B8rQKVAOXqoia91FLBYyn1N03dIQOcpyBM,683
+rosabeats-0.1.3.dist-info/METADATA,sha256=L8ztM95XsgvMYKD5Ae-Zevize47RmoHpmkzQzDMIe5U,6987
+rosabeats-0.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+rosabeats-0.1.3.dist-info/entry_points.txt,sha256=4psFMIAY5kogJyT8RMdFeTpAnRHmZpaFPnlwI3tntuk,208
+rosabeats-0.1.3.dist-info/top_level.txt,sha256=XbOrAF6RZpVfzXdkX9tFRtJFB3RUGXodl7RzoYIfz7A,23
+rosabeats-0.1.3.dist-info/RECORD,,

rosabeats-0.1.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

rosabeats-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+beatrecipe-processor = rosabeats.beatrecipe_processor:main
+beatswitch = rosabeats.beatswitch:main
+rosabeats-shell = rosabeats.rosabeats_shell:main
+segment-song = rosabeats.segment_song:main

rosabeats-0.1.3.dist-info/licenses/LICENSE.md

@@ -0,0 +1,7 @@
+# ISC License
+
+Copyright © 2025 [John Fleming](https://github.com/jbff)
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

rosabeats-0.1.3.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+docs
+rosabeats
+scripts

scripts/reverse_beats_in_bars_rosa.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python
+# shuffle bars in a song with rosabeats
+
+import sys
+
+from rosabeats import rosabeats
+
+if __name__ == "__main__":
+    try:
+        infile = str(sys.argv[1])
+    except:
+        print("must specify input and output file", flush=True)
+        sys.exit(1)
+    try:
+        outfile = str(sys.argv[2])
+    except:
+        print("must specify input and output file", flush=True)
+        sys.exit(1)
+    try:
+        first_bar = int(sys.argv[3])
+    except:
+        first_bar = 0
+    try:
+        beats_per = int(sys.argv[4])
+    except:
+        beats_per = 8
+
+    song = rosabeats(infile, debug=True)
+    song.divide_bars()
+    song.track_beats()
+
+    bar_count = int(song.total_beats / beats_per)
+
+    barlist = [x for x in range(bar_count + 1)]
+
+    song.enable_output_play()
+    song.setup_playback()
+
+    song.enable_output_save(outfile)
+    song.reset_remix()
+
+    song.play_beats([x for x in range(first_bar)])
+    for count, bar in enumerate(barlist):
+        first_b = (count * 8) + first_bar
+        beatlist = [x for x in range(first_b, first_b + beats_per)]
+        beatlist.reverse()
+        song.play_beats(beatlist)
+    song.save_remix()

scripts/shuffle_bars_rosa.py

@@ -0,0 +1,35 @@
+#!/usr/bin/env python
+# shuffle bars in a song with rosabeats
+
+import sys, random
+from rosabeats import rosabeats
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("require one argument that is a file containing music", flush=True)
+        sys.exit(1)
+
+    infile = sys.argv[1]
+    outfile = infile[0:-4] + "_barshuf.wav"
+
+    song = rosabeats(infile, debug=True)
+    song.divide_bars(8, 2)
+    song.track_beats()
+
+    bar_count = int(song.total_beats / 8)
+
+    barlist = [x for x in range(1, bar_count)]
+
+    random.shuffle(barlist)
+
+    song.enable_output_play()
+    song.setup_playback()
+
+    song.enable_output_save(outfile)
+    song.reset_remix()
+
+    song.play_beats([0, 1])
+    song.play_bar(0)
+    song.play_bars(barlist)
+    song.play_bar(bar_count)
+    song.save_remix()

scripts/shuffle_beats_rosa.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python
+# shuffle beats in a song with rosabeats
+
+import sys, random
+from rosabeats import rosabeats
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("require one argument that is a file containing music", flush=True)
+        sys.exit(1)
+
+    infile = sys.argv[1]
+    outfile = infile[0:-4] + "_shuf.wav"
+
+    song = rosabeats(infile, debug=True)
+    song.divide_bars(8, 2)
+    song.track_beats()
+
+    beatlist = [x for x in range(song.total_beats)]
+    random.shuffle(beatlist)
+
+    song.enable_output_play()
+    song.setup_playback()
+
+    song.enable_output_save(outfile)
+    song.reset_remix()
+
+    song.play_beats(beatlist)
+    song.save_remix()