Himig

himig is a Python music synthesis module that lets you compose, play, and save melodies.

Features

• Compose melodies using note names and durations "NOTE:DURATION" format (e.g., "C4:0.5").
• Play melodies directly on your system audio.
• Save melodies as WAV files.
• Generate in-memory WAV bytes for web apps.
• Sample built-in melodies: Happy Birthday, Twinkle Twinkle, Ode to Joy, Für Elise.
• Lightweight: Only depends on numpy.

---

Demo

Himig Playground on Streamlit Cloud 🎶

---

Installation

pip install himig

Or, for development:

git clone https://github.com/j-ncel/himig.git
cd himig
pip install -e .

---

Usage

Play a Melody

from himig import play

melody = ["C4:0.5", "C4:0.5", "G4:1.0"]
play(melody)

Save a Melody as WAV

from himig import save

melody = ["C4:0.5", "C4:0.5", "G4:1.0"]
save(melody, "happy.wav")

Use Built-in Melodies

from himig import play, happy_birthday, twinkle_twinkle

play(happy_birthday)
play(twinkle_twinkle)

Use in Streamlit

import streamlit as st
from himig import generate_wav_bytes, happy_birthday

wav_bytes = generate_wav_bytes(happy_birthday)
st.audio(wav_bytes, format="audio/wav")

---

Melody Format

• Each melody is a list of strings: "NOTE:DURATION"
  • NOTE: Note name (e.g., C4, F#5, Bb3, or R for rest)
  • DURATION: Length in seconds (float or int)
• Example: ["C4:0.5", "G4:1.0", "R:0.25"]

---

Built-in Melodies

• happy_birthday
• twinkle_twinkle

You can import them directly:

from himig import happy_birthday, twinkle_twinkle

You can contribute more melodies to the project—contributions are welcome!

---

Project Structure

himig/
│
├── himig/
│   ├── __init__.py
│   ├── _core.py
│   ├── _audio_player.py
│   ├── constants.py
│   └── melodies.py
├── playground/
│   ├── st-playground.py
│   └── demo.gif
├── tests/
│   └── test_himig.py
├── README.md
├── pyproject.toml
├── requirements.txt
└── LICENSE

---

Links

• GitHub Repository
• PyPI Package

License

This project is licensed under the MIT License. See the LICENSE file for details.

---