🎙️ USS44: Social Media Sampler

USS44 is a high-performance web-based sampler and sequencer designed for the modern era of rapid content creation. Inspired by the legendary workflows of classic samplers but reimagined for a browser-first experience, it allows you to capture, manipulate, and sequence sounds with unparalleled speed.

(Placeholder: Replace with actual screenshot after deployment)

🚀 Try USS44 Live Now!

📖 Read the Full User Manual

✨ Key Features

• 🚀 UltraSample Mode: Fast, intuitive recording directly to pads. One-touch sampling with automatic silence cropping.
• 🎹 16-Pad Performance Grid: Low-latency triggering with full multi-touch support.
• 👯 Pad Cloning: Quickly duplicate any pad's settings and sample to another pad via the Pad Options menu.
• 🎧 Social-Ready Digging: Integrated 'Dig Network' to pull inspiration directly from web-based audio sources.
• 🎛️ Real-time DSP (Applied instantly even during playback):
  • Pitch: High-quality resampling from 0.1x to 4x.
  • Filter: TPT (Topology Preserving Transform) SVF Filter with Cutoff and Resonance control.
  • Envelope: Adjustable Attack and Release per pad.
  • Pan & Gain: Precise spatial and level control.
• 🎼 Step Sequencer: 16-step patterns per pad with velocity, pitch shifting, and note length per step.
• ⏱️ Advanced Tempo Control: Precision Tap Tempo with visual feedback and quick 1/2x or 2x adjustment buttons.
• 💾 Persistence & Library:
  • Automatically saves your last session (BPM, Samples, Patterns) to IndexedDB.
  • Export and Import full projects as .json.
  • Save individual Sounds, Sequences, or full Songs to your local library.

🛠️ Technology Stack

• Core: React + TypeScript + Vite
• Audio Engine: Web Audio API with AudioWorklets for low-latency DSP.
• State Management: Zustand (with functional updates for thread safety).
• Storage: IndexedDB (via a robust custom dbService).
• Icons: Lucide React

🚀 Getting Started

Prerequisites

• Node.js (v18+)
• npm

Installation

1. Clone the repository:

   git clone https://github.com/acidsound/uss44.git

2. Install dependencies:

   npm install

3. Start the Dig Backend (Required for 'Dig Network' feature):

   npm run backend

   Note: This requires yt-dlp and ffmpeg to be installed on your system.

4. Start the development server (in a new terminal):

   npm run dev

   Or run both concurrently:

   npm run dev:all

🏗️ Deployment

This project is configured to deploy automatically to GitHub Pages via GitHub Actions.

• Base URL: ./ (configured in vite.config.ts for relative path compatibility).
• CI/CD: .github/workflows/deploy.yml handles the build and deployment on every push to main.

📄 License

MIT License. Designed with ❤️ by acidsound.