Skip to content

README.md

Latest commit

 

History

History
160 lines (114 loc) · 5.21 KB

README.md

File metadata and controls

160 lines (114 loc) · 5.21 KB

SoundCraft: Personal Audio System

Welcome to SoundCraft/ — my self-hosted, version-controlled, fully automated music system.

This is more than a project. It's a creative engine — a digital studio, archive, and publishing system for everything I make as a musician, guitarist, and producer.

All content here is original and handcrafted: riffs, beats, short songs, tabs, MIDI, video, presets, and metadata.

🎯 Purpose

This system was built to:

  • Archive and share my music: guitar riffs, beats, songs, videos, and more
  • Automate playlist creation, metadata generation, and validation
  • Apply systems thinking and coding to creative output
  • Create a sharable, open, and negotiable music platform
  • Build a legacy of structured, reproducible art
  • Provide a clear licensing framework for both non-commercial and commercial use

📂 Folder Architecture

SoundCraft/
├── SHORT-SONGS/     # Finalized short MP3 tracks
├── BEATS/           # Drum patterns, sample loops
├── GUITAR-RIFFS/    # Raw or processed guitar snippets
├── TABS/            # Guitar tablature (PDF, TXT, .gp5, etc.)
├── MIDI/            # MIDI files and project ideas
├── VIDEOS/          # Music videos or visual snippets
├── RAW/             # WAVs, DI, stems, multitrack sessions
├── PRESETS/         # Quad Cortex or plugin presets
├── METADATA/        # Markdown descriptions of each item
├── PLAYLISTS/       # .m3u or .json playlists
└── .vscode/         # VS Code workspace settings

Each folder serves a specific purpose in organizing and managing different types of musical content:

  • SHORT-SONGS: Complete, finalized tracks ready for distribution
  • BEATS: Drum patterns and sample loops for production
  • GUITAR-RIFFS: Guitar recordings, both raw and processed
  • TABS: Guitar tablature in various formats
  • MIDI: MIDI files and project ideas for further development
  • VIDEOS: Music videos and visual content
  • RAW: Original recordings, stems, and multitrack sessions
  • PRESETS: Equipment and plugin presets
  • METADATA: Documentation and descriptions for all content
  • PLAYLISTS: Curated collections of tracks
  • .vscode: Development environment configuration

🧠 Tech Stack

  • OS: Windows 11 (primary), macOS + iOS (secondary)
  • Gear: Quad Cortex, guitar, DAWs (FL Studio, Logic, GarageBand)
  • Language: Go (backend automation)
  • Workflow: Git, GitHub, local automation, blog export (Astro)

🚀 Roadmap

Phase Feature Status
1 Folder system and Git setup ✅ Done
2 Playlist + metadata generators 🔄 In Progress
3 Asset validation and coverage checks ⏳ Planned
4 Export to Astro blog 🔜 Future
5 GitHub Actions for publishing 🔜 Future
6 CLI for tagging/publishing 🔜 Stretch
7 Project analytics and insights ✅ Done

🎵 Features

Project Analysis

The system now includes a comprehensive project analysis tool that provides insights into your music production:

  • File Type Distribution: Shows the breakdown of audio files (MP3, WAV, MIDI) and their percentages
  • File Size Analysis:
    • Total project size
    • Average file size
    • Largest and smallest files
    • All sizes in human-readable format
  • Directory Structure:
    • Total directories and files
    • Audio file percentage of total files
  • File Age Analysis:
    • Oldest and newest files with timestamps
    • Project age calculation

To use this feature, run the program and select "Analyze Project" from the menu.

📜 License

All original works in this system are licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).

You can:

  • Use and remix the material for non-commercial purposes
  • Share your adaptations with credit and under the same license
  • Contact me for commercial licensing opportunities

For full license details, see LICENSING-MY-MUSIC.md.

Attribution Requirements

When using my songs, you must include:

Name: Antonio Rodriguez Martinez (aka Antoniwan)
Link: https://stronghandssoftheart.com
Project: SoundCraft
License: CC BY-NC-SA 4.0

🤝 Collaboration and Licensing

Want to use this music in a film, podcast, game, or paid project?

I'm open to licensing, sync rights, and collaborations. Let's build something together.

📧 hello@stronghandssoftheart.com
🌐 https://stronghandssoftheart.com

✅ To-Do Checklist

  • Establish folder system
  • Create initial README and LICENSE
  • Set up basic Git repository
  • Build generate_playlist.go
  • Build generate_metadata.go
  • Build validate_assets.go
  • Add real content to SHORT-SONGS, BEATS, GUITAR-RIFFS
  • Export selected content to Astro blog
  • Build automation CLI

🧙‍♂️ Final Word

This is my musical core.
A ritual space.
A structured outlet.
A living archive.

Welcome to the forge.