A Chrome extension that automates the process of generating certified licenses for multiple Splice samples at once.
The Splice License Batch Generator streamlines the tedious process of generating licenses for Splice samples. Instead of manually navigating to each sample and generating licenses one by one, this extension allows you to:
- π Batch Process: Generate licenses for multiple samples simultaneously
- β‘ Fast & Efficient: Direct API integration for quick processing
- π Secure: Uses your existing Splice login, no credentials stored
- πΎ Smart: Remembers your work across sessions
- β Reliable: Verifies samples are in your library before generation
- Batch License Generation: Process multiple samples at once
- Automatic Authentication: Detects your Splice login automatically
- Library Verification: Checks if samples are in your library
- One-Click Downloads: Download licenses with a single click
- State Persistence: Your input and results are saved automatically
- Clean Interface: Simple, intuitive popup design
- Real-Time Feedback: Progress updates and status indicators
- Error Handling: Clear error messages with helpful guidance
- No Tab Switching: Popup stays open during processing
- GraphQL API Integration: Direct API calls for speed
- Cookie-Based Auth: Reliable login detection
- Page Context Injection: Bypass CORS restrictions
- Background Processing: Hidden tabs for API operations
Install from Chrome Web Store π
One-click installation, automatic updates, and verified by Google.
-
Clone the Repository
git clone https://github.com/owenbush/splice-chrome-extension.git cd splice-chrome-extension -
Load in Chrome
- Open Chrome and go to
chrome://extensions/ - Enable "Developer mode" (toggle in top-right)
- Click "Load unpacked"
- Select the
splice-chrome-extensiondirectory
- Open Chrome and go to
- Configure License Info
- Click the extension icon
- Click "Open Settings"
- Enter your Full Legal Name and Artist Name
- Click "Save License Information"
-
Log in to Splice
- Open splice.com and log in
- Keep the tab open
-
Enter Sample Names
- Click the extension icon
- Paste sample names (one per line) in the text area
- Include the
.wavextension
-
Generate Licenses
- Click "Process Samples"
- Wait for processing to complete
- Click "Download License" for each successful generation
π For detailed instructions, see USER_GUIDE.md
- Browser: Google Chrome 88 or higher
- Account: Active Splice.com account with library samples
- Network: Stable internet connection
splice-chrome-extension/
βββ manifest.json # Extension configuration
βββ background/
β βββ service-worker.js # Background tasks & API coordination
βββ content/
β βββ content-script.js # Splice.com page interaction
β βββ page-script.js # Page context for auth tokens
βββ popup/
β βββ popup.html # Extension popup interface
β βββ popup.css # Popup styling
β βββ popup.js # Popup logic
βββ options/
β βββ options.html # Settings page
β βββ options.css # Settings styling
β βββ options.js # Settings logic
βββ shared/
β βββ encryption.js # Data encryption utilities
β βββ utils.js # Shared utility functions
βββ memory-bank/ # Project documentation
βββ projectbrief.md # Project overview
βββ activeContext.md # Current work status
βββ progress.md # Development progress
βββ techContext.md # Technical details
βββ systemPatterns.md # Architecture patterns
The extension uses a modular architecture with three main components:
-
Service Worker (
background/service-worker.js)- Coordinates API requests
- Manages session detection
- Handles message passing
-
Content Script (
content/content-script.js)- Interacts with Splice.com pages
- Makes authenticated GraphQL requests
- Extracts authentication tokens
-
Popup Interface (
popup/)- User input and output
- State management
- Result display
graph TD
A[User Opens Popup] --> B[Check Cookies]
B --> C{Has _splice_token_prod?}
C -->|Yes| D[Logged In]
C -->|No| E[Not Logged In]
D --> F[Enable Processing]
E --> G[Show Login Prompt]
graph TD
A[User Submits Samples] --> B[For Each Sample]
B --> C[Search via GraphQL]
C --> D{Found?}
D -->|No| E[Show Error]
D -->|Yes| F{In Library?}
F -->|No| G[Show Warning]
F -->|Yes| H[Generate License]
H --> I[Provide Download Link]
- Manifest V3: Modern Chrome extension API
- Vanilla JavaScript: No frameworks, lightweight
- GraphQL: Direct Splice API integration
- Chrome APIs: Storage, Tabs, Cookies, Scripting
- Cookie-Based Auth:
_splice_token_prodis the reliable auth indicator - GraphQL API: Direct API calls instead of DOM scraping
- Page Context Injection: Accesses localStorage for Bearer tokens
- Hidden Tabs: Background tabs for API operations without disruption
To enable detailed logging:
- Open Chrome DevTools on the popup
- Check the Console tab
- Errors and status messages will appear there
| Issue | Solution |
|---|---|
| "Not logged in" error | Refresh Splice.com tab and reopen popup |
| "Sample not in library" | Add sample to library on Splice.com first |
| "Sample not found" | Verify exact filename with .wav extension |
| Extension closes | Keep a Splice.com tab open |
See USER_GUIDE.md for comprehensive troubleshooting.
- USER_GUIDE.md: Complete user documentation
- memory-bank/activeContext.md: Current development status
- memory-bank/techContext.md: Technical documentation
- memory-bank/systemPatterns.md: Architecture patterns
Contributions are welcome! Here's how you can help:
- Report Bugs: Open an issue with details and steps to reproduce
- Suggest Features: Share ideas for improvements
- Submit PRs: Fork, make changes, and submit a pull request
- Improve Docs: Help make documentation clearer
# Clone the repo
git clone https://github.com/yourusername/splice-chrome-extension.git
# Load in Chrome
# 1. Go to chrome://extensions/
# 2. Enable Developer mode
# 3. Click "Load unpacked"
# 4. Select the project directory
# Make changes and reload
# Click the reload icon in chrome://extensions/- β Core Functionality: Complete
- β Authentication: Working
- β License Generation: Functional
- β Error Handling: Comprehensive
- β Documentation: Complete
- π Chrome Web Store: Not yet submitted
- No Data Collection: Extension doesn't collect or transmit user data
- Local Storage Only: Settings stored locally in your browser
- Session Piggybacking: Uses your existing Splice login
- No Credentials Stored: Never stores your Splice username or password
- Minimal Permissions: Only requests necessary Chrome permissions
This project is licensed under the MIT License - see the LICENSE file for details.
Owen Bush
- GitHub: @owenbush
- Splice.com: For providing an excellent sample library platform
- Chrome Extensions Documentation: For comprehensive API guides
- GraphQL Community: For excellent tooling and resources
This extension is an independent project and is not affiliated with, endorsed by, or associated with Splice.com. Always comply with Splice's Terms of Service when using this tool.
Having issues? Check these resources:
- USER_GUIDE.md: Comprehensive user documentation
- Troubleshooting Section: Common issues and solutions
- GitHub Issues: Report bugs or request features
β If you find this extension helpful, please star the repo!
Last updated: October 2025