{"id":27471053,"url":"https://github.com/hklyousfi/cyberxnoteloom","last_synced_at":"2026-04-30T14:34:23.596Z","repository":{"id":287713779,"uuid":"965551925","full_name":"HKLYousfi/CyberXNoteloom","owner":"HKLYousfi","description":"Hybrid piano synthesizer with ADSR envelopes, resonance modeling, and MIDI rendering​","archived":false,"fork":false,"pushed_at":"2025-04-13T13:26:23.000Z","size":28,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-13T14:25:55.628Z","etag":null,"topics":["adsr-envelope","digital-audio","hybrid-synth","midi-processor","numpy","piano-synthesizer","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HKLYousfi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"License.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-13T12:17:59.000Z","updated_at":"2025-04-13T13:26:26.000Z","dependencies_parsed_at":"2025-04-13T14:26:07.044Z","dependency_job_id":"a296ba0b-c0b5-4899-b59b-f8b96e7b49dd","html_url":"https://github.com/HKLYousfi/CyberXNoteloom","commit_stats":null,"previous_names":["hklyousfi/cyberxnoteloom"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HKLYousfi%2FCyberXNoteloom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HKLYousfi%2FCyberXNoteloom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HKLYousfi%2FCyberXNoteloom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HKLYousfi%2FCyberXNoteloom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HKLYousfi","download_url":"https://codeload.github.com/HKLYousfi/CyberXNoteloom/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249182786,"owners_count":21226123,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adsr-envelope","digital-audio","hybrid-synth","midi-processor","numpy","piano-synthesizer","python"],"created_at":"2025-04-16T01:38:19.432Z","updated_at":"2026-04-30T14:34:23.532Z","avatar_url":"https://github.com/HKLYousfi.png","language":"Python","funding_links":["https://paypal.me/HaykelYousfi?country.x=FR\u0026locale.x=fr_FR"],"categories":[],"sub_categories":[],"readme":"# CyberXNoteloom: MIDI-to-Multi-Format Audio Converter\n\n**Under Development – Do Not Distribute Unauthorized Copies**\n\n---\n\n## Overview\n\nCyberXNoteloom is a fully optimized, professional-grade digital piano solution that converts MIDI files or musical notation (from TXT or DOCX files) into high-quality audio formats (WAV, FLAC, MP3, AAC, WMA) without any external instruments. The project uses an advanced synthesis engine with dynamic ADSR envelopes, a robust signal processing pipeline featuring polyphase oversampling, high-end FIR filtering, soft-knee dynamics, and TPDF dithering, combined with state-of-the-art DSP effects (composite reverb and multi-band EQ) and superior encoding techniques leveraging SoundFile and FFmpeg.\n\n---\n\n## Mission Statement\n\nThis project was created for a noble cause—to empower those passionate about piano but who cannot afford expensive instruments. CyberXNoteloom enables aspiring musicians (including children) to practice and develop their skills by providing a full, software-based digital piano experience.\n\nAs a music enthusiast, electromechanical, and marine engineer, I (Haykel Yousfi) believe that music should be accessible to everyone. Your support fosters further innovative projects and encourages building high-quality musical tools. [![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://paypal.me/HaykelYousfi?country.x=FR\u0026locale.x=fr_FR)\n\n---\n\n## How a Piano Works\n\n### The Basics\n- **Keys \u0026 Hammer Mechanism:** When you press a piano key, it triggers a hammer to strike the corresponding strings. The vibration produces the musical sound.\n- **Soundboard:** Amplifies the sound created by the vibrating strings.\n- **Pedals:** For sustain, softening, and selective note sustain.\n\n### Keyboard Layout\n- **White Keys:** Represent natural notes (A, B, C, D, E, F, G).\n- **Black Keys:** Represent sharps/flats grouped in twos and threes.\n- **Middle C (C4):** A central reference point.\n- **Octaves \u0026 Chords:** Understand the grouping and how scales/chords (e.g., major and minor) are built.\n\n---\n\n## Features\n\n- **Realistic Synthesis Engine:**  \n  - Uses sine-wave oscillators enriched with harmonics.\n  - Applies ADSR envelopes for natural attack, decay, sustain, and release.\n  - Supports dynamic parameters based on the musical style, transposition, and piano type.\n\n- **Robust Note Parsing:**  \n  - Parses standard MIDI files.\n  - Converts musical notation from TXT or DOCX files into MIDI events (e.g., \"[G3A#3]| [G3A#3] ...\").\n\n- **Advanced DSP Processing:**  \n  - Oversampling with polyphase resampling.\n  - Kaiser-windowed FIR filtering for anti-aliasing.\n  - Soft-knee dynamics processing and TPDF dithering for pristine audio.\n  - Advanced reverb (composite of early reflections and long tail) and multi-band EQ.\n\n- **Multi-Format Encoding:**  \n  - Exports audio using SoundFile for WAV and FLAC.\n  - Leverages FFmpeg for MP3, AAC, and WMA conversion.\n  \n- **Additional Parameters:**  \n  - Style (e.g., \"Pop\")\n  - Target Length (formatted as \"MM:SS\")\n  - Transposition (e.g., shift notes by semitones)\n  - Tempo (BPM override)\n  - Piano Type (e.g., \"CLASSICAL PIANO\", \"GRAND CLASSICAL PIANO\", etc.)\n\n- **Modular Design \u0026 Testing:**  \n  - Clear separation into modules with unit tests for reliability.\n\n---\n\n## Installation\n\n### Prerequisites\n\n- Python 3.6 or higher\n- FFmpeg must be installed and available in your PATH.\n\n## Donate with PayPal\n\n[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://paypal.me/HaykelYousfi?country.x=FR\u0026locale.x=fr_FR)\n\n\n### Python Dependencies\n\nInstall the required packages using:\n\n```bash\npip install -r requirements.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhklyousfi%2Fcyberxnoteloom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhklyousfi%2Fcyberxnoteloom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhklyousfi%2Fcyberxnoteloom/lists"}