# SetLedger - Full Documentation > DJ analytics software for tracking, analyzing, and improving DJ performances. Built by The Syndrical Project Inc. ## Overview SetLedger is a web-based DJ analytics platform that transforms raw session history into actionable performance insights. It reads exported CSV files from Serato DJ software, automatically detects individual sessions, and generates detailed analytics about track selection, pacing, rotation patterns, and venue performance. Unlike general music analytics tools, SetLedger is purpose-built for the workflow of performing DJs. It understands the structure of a DJ set -- the progression from opener to peak to closing, the deliberate BPM journey, and the decisions made in real time about which tracks to play and when. SetLedger does not require any integrations, API connections, or streaming service accounts. It works entirely from the CSV history files that Serato already generates. All data remains private to each user, secured with row-level security policies that ensure no user can access another's session data under any circumstances. ## Who SetLedger Is For SetLedger serves working DJs across all formats and environments: - Club DJs who want to track what they play across venues and avoid repeating sets for regular audiences - Mobile DJs managing events like weddings, corporate functions, and private parties who want to compare performance across event types - Resident DJs analyzing crowd preferences at recurring events and tracking which songs consistently work at their venue - Music curators and open-format DJs monitoring track rotation, identifying songs that are rising in their sets, tracks that have peaked, and forgotten gems that deserve another play - Any DJ who uses Serato and wants data-driven insights to improve their craft ## How It Works ### Step 1: Export Your Serato History Serato DJ Pro and Serato DJ Lite automatically log every track played during a session. This history is stored locally on your computer. To use SetLedger, you export this history as a CSV file from within Serato's History panel. The exported CSV contains one row per track played, including the track title, artist, start time, end time, play duration, BPM, and key. You can export a single session, a date range, or your entire history -- SetLedger handles all three scenarios. No additional software or plugins are required. SetLedger works with the standard CSV export that Serato already provides. ### Step 2: Upload to SetLedger After creating a free account, you upload your CSV file through a drag-and-drop interface. SetLedger parses the file, identifies individual sessions by detecting time gaps between tracks, and presents each detected session for review before saving. During upload, you can tag each session with a venue name, event type (nightclub, bar, wedding, corporate, etc.), and event series name for recurring gigs. The system generates a content fingerprint for duplicate detection -- if the session has been uploaded before, you are notified immediately. Pro users can batch-upload multiple CSV files simultaneously, processing weeks or months of history in a single operation. The batch importer handles each file independently, reporting successes and duplicates separately. ### Step 3: Explore Your Analytics Once sessions are uploaded, analytics are available immediately. The dashboard provides an overview of total sessions, total tracks, average BPM, and other summary statistics. From there, you can explore specific analytics views: - Session timelines showing every track played with duration and BPM - BPM journey charts visualizing energy flow across a set - Most-played tracks with trend indicators - Track rotation status (Rising, Declining, In Rotation, Retired) - Venue-specific analytics and top songs per venue - Genre and key distribution charts - Performance metrics (tracks per hour, average duration, pacing) - Forgotten songs that have dropped out of rotation Each view supports time-range filtering, allowing you to compare performance across different periods -- last 30 days versus last 6 months, for example. ### Step 4: Track Your Growth Over Time The value of SetLedger compounds with use. As more sessions are uploaded, the analytics become richer and more revealing. Rotation analysis requires multiple sessions to establish baselines. Trend data becomes meaningful after a few weeks. Venue comparisons require sessions at more than one location. DJs who upload consistently gain visibility into their evolution as selectors -- how their tastes shift, which new tracks earn a permanent place in rotation, and how their pacing and energy management develop across months and years of performance. ## Features ### Session Intelligence - Automatic session detection from CSV exports (time-gap analysis) - Duplicate upload prevention via content fingerprinting - Venue tagging with autocomplete for previously used venue names - Event type categorization (nightclub, bar, wedding, corporate, festival, restaurant, private) - Event series tracking for recurring gigs - Bulk session management (Pro) - Custom time range filtering - Session repair via CSV re-upload - Bulk track deletion with session auto-cleanup ### Track Insights - Most played tracks across all sessions with ranked listing - Track rotation status classification: In Rotation, Rising (20%+ increase), Declining (20%+ decrease), Retired - Forgotten songs reminders -- tracks that have dropped out of rotation - Track familiarity scoring (new vs. familiar tracks per session) - Individual track metadata editing (override song title, artist, BPM) - Track detail pages with play history and trend charts (Pro) - Top tracks by venue analysis (Pro) - Top tracks by event series analysis (Pro) ### Performance Metrics - Session timelines with exact play times for every track - Average track duration and pacing analysis - Longest and shortest plays identification - Tracks per hour rate calculation - BPM journey visualization (line chart across set) - Session duration tracking - Track count per session - Excluded track detection (too short or too long plays) ### Smart Analytics - Rising tracks detection (20%+ increase in recent play frequency) - Declining tracks detection (20%+ decrease in play frequency) - Retired tracks identification (tracks no longer being played) - Key distribution statistics with harmonic mixing insights (Pro) - Genre distribution analytics (Pro) - Venue performance comparisons (Pro) - Event series performance comparisons (Pro) - Cross-session trend analysis (Pro) - Time-scoped analytics (30 days, 90 days, 6 months, 1 year, all time) ### Data Management - Custom column visibility preferences (choose which data columns to display) - Track editing (override raw CSV data with corrected metadata) - Session deletion with confirmation - Bulk track selection and deletion - Account deletion with full data removal - CSV/PDF export of analytics (Pro, planned) ## Pricing ### Free Plan - $0 forever Perfect for new DJs and exploring the platform. Includes: - No credit card required - Secure authentication and profile - Single CSV upload (Serato History) - Full session timeline view - BPM Journey visualization - Session performance metrics - Track familiarity indicators - Track metadata editing - Custom column visibility - Most Played Tracks (ranked) - Track rotation intelligence (Rising, Declining, Retired) - Responsive UI (mobile, tablet, desktop) - Session repair via CSV re-upload - Full data privacy via RLS Limits: 10 sessions, 90 days of history access ### Pro Plan - $5/month or $50/year For working DJs who need unlimited analytics. Everything in Free, plus: - Unlimited sessions and historical access - Bulk CSV uploads - Forgotten songs reminders - Individual track detail pages with trends - Venue tagging with autocomplete - Venue analytics and top tracks by venue - Event type tagging - Genre analytics (if data present in CSV) - Key analytics (if data present in CSV) - Cross-session trend analysis - Advanced filtering and sorting - Advanced exports (CSV/PDF) - Future DJ software imports Limits: Unlimited sessions, all-time history access ### Founding DJ Plan - $100 one-time Lifetime Pro access for early supporters. Limited to 10 spots. Includes: - Lifetime Pro access at no recurring cost - All current Pro features included - All future Pro-tier features guaranteed - Early access to new DJ software imports - Priority feedback and feature requests - Founding DJ badge and recognition - No subscription, no renewals, ever Note: Includes lifetime SetLedger Pro tier access only. Does not include future separate products, team/venue plans, or enterprise offerings. ## Supported Software SetLedger currently supports CSV history exports from: - Serato DJ Pro - Serato DJ Lite These are industry-standard DJ applications used by millions of DJs worldwide, and their history export format provides the track-level detail needed for meaningful analytics. Support for additional DJ software (Rekordbox, Traktor, VirtualDJ) is planned for future releases. The analytics engine is format-agnostic -- only the import parser is specific to Serato's CSV structure. ## Data Model SetLedger organizes DJ data into the following hierarchy: - **Profiles**: User accounts with subscription tier, DJ name, and preferences - **Venues**: Named locations where sessions take place (unique per user, case-insensitive) - **Event Series**: Recurring gig names for grouping sessions (e.g., "Friday Residency at Club X") - **Sessions**: Individual DJ sets with metadata (date, venue, event type, duration, track count, tracks per hour, BPM range) - **Tracks**: Normalized track identities (deduplicated by artist + song per user) - **Play Events**: Individual track plays within a session (start time, end time, duration, BPM, key, raw and override metadata) Each session is identified by a content fingerprint to prevent duplicate uploads. Play events reference both the session they belong to and the normalized track identity, enabling cross-session analytics. ## Data Security and Privacy - All uploaded session data is stored securely with row-level security (RLS) policies - Each user can only access their own data -- privacy is enforced at the database level - No mechanism exists for users to view, share, or expose each other's sessions - SetLedger does not sell or share user data with third parties - No advertising, no social features, no data monetization - Session history belongs entirely to the user - Full account deletion available with complete data removal - Email/password authentication with secure session management ## Technical Architecture - Frontend: React 18 single-page application with TypeScript - Build tool: Vite - Styling: Tailwind CSS with responsive design - State management: TanStack React Query for server state - Animations: Framer Motion - Backend: Supabase (PostgreSQL with row-level security) - Authentication: Supabase Auth (email/password) - Payments: Polar.sh integration - Hosting: Static site deployment with SPA routing ## Frequently Asked Questions **How do I upload my Serato history?** Export your session history from Serato as a CSV file, then drag and drop it into SetLedger. Sessions are automatically detected, duplicates removed, and data organized. **What are the differences between Free and Pro plans?** Free includes 10 sessions, 90 days of history, and core analytics. Pro ($5/month or $50/year) unlocks unlimited sessions, all-time history, bulk uploads, track rotation analytics, venue tracking, genre/key analytics, forgotten songs reminders, and advanced exports. **What happens when I reach the Free plan limits?** You'll be prompted to upgrade to Pro. Existing data remains accessible, but new uploads are restricted. You can delete older sessions to make room if you prefer to stay on Free. **Is the Founding DJ plan really lifetime access?** Yes. One-time payment of $100 provides lifetime access to all Pro-tier features with no recurring payments. Includes all future features added to the Pro tier. Limited to 10 spots. **Can I upgrade or downgrade my plan?** Yes. Upgrade from Free to Pro at any time. Downgrading from Pro to Free preserves your data but limits access to 10 sessions and 90 days of history. **Is my data private and secure?** Yes. Enterprise-grade row-level security ensures your data is completely isolated and only accessible to you. SetLedger never shares, sells, or analyzes personal DJ data. **What file formats do you support?** CSV exports from Serato DJ Pro and Serato DJ Lite. Additional formats (Rekordbox, Traktor, VirtualDJ) are planned. **How does duplicate detection work?** SetLedger uses content fingerprinting to detect when you upload the same session twice. It analyzes track sequences and timestamps to prevent duplicate entries while allowing overlapping time periods safely. **Can I get a refund?** 30-day money-back guarantee for Pro subscriptions. Founding DJ plan sales are final due to limited availability and lifetime access nature. ## Links - Homepage: https://getsetledger.com/ - About: https://getsetledger.com/about - Features: https://getsetledger.com/features - How It Works: https://getsetledger.com/how-it-works - Privacy Policy: https://getsetledger.com/privacy - Terms of Service: https://getsetledger.com/terms - LLMs Summary: https://getsetledger.com/llms.txt ## Contact For questions or support: hello@getsetledger.com SetLedger is a product of The Syndrical Project Inc., based in Canada. Built by DJs, for DJs, with a focus on data privacy, clean design, and genuine utility for working performers.