Riffusion Multitool
Supercharge your Riffusion library management with this comprehensive userscript. It seamlessly integrates a powerful, yet compact, control panel onto Riffusion pages, offering advanced features like Selective Deletion, Bulk Deletion (use with extreme caution), a highly configurable Download Queue, and now, robust Privacy Status Management. The interface starts minimized as a discreet "RM" icon in the top-right corner, expanding into a draggable panel upon click for efficient track management.
Core Features:
- Minimizable & Draggable UI:
- Initiates as a small "RM" icon (top-right) for an unobtrusive presence.
- Click the icon to reveal the full panel; click "_" to minimize.
- The panel's last position and list heights are remembered for session consistency.
- Compact design optimizes screen real estate.
- Intuitive Main Menu Navigation: Easily switch between dedicated tools: Selective Deletion, Bulk Deletion, Download Queue, and Privacy Status.
- Dynamic Song Lists:
- Song lists in all tools automatically update as new songs are loaded on the Riffusion page (e.g., via infinite scroll), ensuring your view is always current.
- User checkbox selections are preserved during these automatic updates.
- Resizable list height: Click and drag the resizer below song lists to customize their visible height.
- Manual Reload Option: An "Auto-Update Lists" checkbox (contextually shown in relevant views) allows disabling automatic updates in favor of manual "Reload List" buttons.
- Selective Deletion Tool:
- Reliably delete specific songs using their unique identifiers.
- Advanced filtering:
- Option to Ignore Liked Songs.
- Keyword-based filter to exclude songs with specific terms in their titles.
- "Select All Visible" functionality for quick selection based on current filters.
- Bulk Deletion Tool:
- Designed for rapid clearing of your entire Riffusion library.
- Efficiently processes deletions without requiring manual scrolling, incorporating retry logic for robustness.
- ⚠️ EXTREME CAUTION IS PARAMOUNT WHEN USING THIS FEATURE.
- Advanced Download Queue Tool:
- Sequentially download multiple selected songs.
- Multi-Format Selection: Choose from MP3, M4A, and/or WAV via checkboxes. The script will download all selected formats for each song before proceeding to the next.
- Configurable Delays: Independently set delays (in seconds) for:
- Intra-format downloads (between different formats of the same song).
- Inter-song downloads (between different songs in the queue).
- Sophisticated Filtering & Selection:
- Keyword filter to dynamically narrow down the displayed song list.
- "Select All" for currently visible songs.
- "Select/Deselect Liked" button (dynamically updates its text).
- "Clear Selection" button for quick deselection.
- Privacy Status Management Tool (NEW):
- Batch update the privacy settings of your Riffs.
- Set selected songs to "Only Me," "Anyone with the link," or "Publish."
- Independent Filtering & Selection:
- Keyword filter for the privacy song list.
- "Select All Visible," "Select/Deselect Liked," and "Clear Selection" options.
- Configurable Inter-Song Delay: Set a delay (in seconds) between processing each song's privacy update.
- Reliable Operation: Employs specific song identifiers and includes retry mechanisms for enhanced stability across all tools.
- Debug Mode: Optional, detailed console logging for advanced users or troubleshooting (toggle available in the Main Menu).
Rationale:
Manually managing a large Riffusion library—deletions, multi-format downloads, or privacy updates—can be repetitive and time-consuming. This script automates these tasks, offering significant efficiency gains. The Download Queue is particularly beneficial for backups in multiple audio formats, and the Privacy tool streamlines sharing preferences, all with controlled timing. The minimizable UI ensures the tool remains accessible without cluttering the Riffusion interface.
⚠️ CRITICAL USAGE ADVISORY ⚠️
- All actions (deletion, privacy changes) bypass standard Riffusion confirmation dialogues.
- Deletions are immediate and permanent. THERE IS NO UNDO CAPABILITY.
- Exercise extreme diligence before initiating any operation.
- It is strongly recommended to first test with Selective Mode or Privacy Mode on a small number of non-critical songs to verify correct operation before considering Bulk Deletion or large-scale changes.
- The Download Queue and Privacy tool automate click actions rapidly. Ensure delay settings are appropriate for your system and network.
- Future updates to the Riffusion website may potentially impact the script's functionality. Please report any encountered issues.
Operational Guide:
- Install the userscript via a compatible browser extension (e.g., Tampermonkey, Violentmonkey).
- Navigate to any
https://www.riffusion.com/ page (song lists are primarily found on /library/my-songs).
- A small "RM" icon will appear in the top-right corner. Click it to open the Multitool panel.
- The Main Menu provides access to the tools:
- Selective Deletion:
- Use filters (Ignore Liked, Keyword Ignore) to refine the list.
- If "Auto-Update Lists" is off, click "Reload List" to populate/refresh.
- Select songs (or "Select All Visible"). Click "Delete Selected".
- Bulk Deletion:
- Click "Delete Entire Library". VERIFY YOUR INTENT ABSOLUTELY. Acknowledge the in-script warning.
- Download Queue:
- Optionally filter the list. Reload if auto-update is off.
- Choose Download Formats (MP3, M4A, WAV).
- Adjust Inter-Song and Intra-Format Delays if needed.
- Select songs (or use "Select All", "Select/Deselect Liked", "Clear Selection" ("C") button).
- Click "Start Download Queue".
- Privacy Status:
- Optionally filter the list. Reload if auto-update is off.
- Select the target privacy level from the dropdown.
- Adjust Inter-Song Delay if needed.
- Select songs.
- Click the "Change Status" button (text will reflect chosen action).
- Monitor the status message at the bottom of the panel for feedback.
- Use "Back to Menu" within each tool to return.
- Click "_" in the panel header to minimize.
Compatibility:
- Developed and tested on Google Chrome with Tampermonkey.
- Designed for
https://www.riffusion.com/*, with core list functions most relevant on pages displaying song lists (e.g., /library/my-songs).
