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.