Beat

What This Skill Does

Beat is a powerful, offline-first command-line tool designed to streamline music and audio file management directly from your terminal. Whether you are an audiophile, a music producer, or simply someone looking to organize a vast collection of media, Beat provides a comprehensive suite of utilities to track, analyze, and manipulate your audio library. By leveraging a local-first architecture, it ensures that your metadata and personal music data remain securely on your machine without relying on external cloud services.

Key capabilities include file conversion, metadata analysis, batch processing, and detailed statistical reporting. Every interaction is automatically logged, allowing you to track your organization habits and maintain an audit trail of your library's evolution over time.

Installation

To install the Beat skill, run the following command in your OpenClaw terminal:

clawhub install openclaw/skills/skills/bytesagain3/beat

Once installed, you can verify it by running beat status to ensure your data directory is initialized correctly at ~/.local/share/beat/.

Use Cases

• Library Auditing: Use Beat to scan your music directories and generate reports on file formats, sizes, and total entry counts.
• Batch Conversion: Efficiently convert multiple audio files to different formats for mobile compatibility or storage optimization.
• Metadata Analysis: Analyze audio files to extract detailed insights, which can then be exported as JSON or CSV for use in other applications.
• Activity Tracking: Maintain a log of all modifications made to your audio collection to prevent accidental loss or to simply keep a history of your organizational efforts.

Example Prompts

1. "Beat, analyze all FLAC files in my music folder and generate a JSON report of their metadata."
2. "I need to convert my recent playlist from WAV to MP3; use the beat batch command to handle this."
3. "Show me the statistics for my audio library and tell me the total disk space usage currently occupied by my collection."

Tips & Limitations

• Offline Privacy: Because Beat operates locally, it is inherently private, but it means you are responsible for backing up the ~/.local/share/beat/ directory manually using the beat export command.
• Performance: For extremely large libraries (tens of thousands of files), ensure your local storage has sufficient I/O performance to handle bulk analysis.
• Command Scope: Beat is optimized for terminal users; it does not feature a graphical user interface, so familiarity with basic shell operations will enhance your efficiency.