Custom
Custom
Take full control of your dictation processing with Custom Mode. Create specialized workflows by combining context-awareness with your own AI instructions for unlimited possibilities.
Key Features
Custom Mode empowers you with:- Complete control over AI processing instructions
- Context-awareness capabilities
- Flexible processing for any workflow
Additional Settings
AI Instructions
Beyond selecting your preferred AI model, with Custom Mode you have the option to personalize your own AI processing instructions.
Instructions are empty by default. If left blank, AI will not know what task to perform and may give unexpected results.
Context Awareness
- Application context toggle
- Copied text toggle
These toggles work identically to Super Mode context awareness features.
Prompting Tips
Referencing Content
Referencing Content
When writing AI instructions for use in Superwhisper, you can direct AI’s attention to specific content using these naming conventions:
These titles let you create targeted instructions for AI. For example:
Instruct AI exactly which content to focus on and what to do with it. You can combine them in your instructions to create powerful workflows:
User Message- Contains your dictated text
Application Context- Includes the data from your active application window
Clipboard Context- Contains the text you’ve copied
These titles let you create targeted instructions for AI. For example:
- “Translate the User Message to Spanish”
- “Based on the Application Context, suggest relevant code comments”
- “Format the User Message accordingly based on the content found in Clipboard Context”
If you want AI to know your input is dictated speech, include it explicitly. For example: “The User Message contains dictated text. Please format it into proper paragraphs.”
Instruct AI exactly which content to focus on and what to do with it. You can combine them in your instructions to create powerful workflows:
Writing Effective Instructions
Writing Effective Instructions
1
Clear Purpose
Define your AI instructions by starting with a clear role or purpose statement. This sets the foundation for how the AI will process your content.
2
Requirements
Create a detailed list of specific requirements and expectations. Being explicit helps ensure the AI understands exactly what you need.
3
Structure
Organize your instructions using separate sections for different components. This modular approach makes your instructions easier to understand and modify.
4
Keep Simple
Write direct, straightforward instructions without unnecessary complexity. Clear communication leads to better results.
Using XML Tags
Using XML Tags
Add Examples
Add Examples
Examples help you teach AI exactly how to process your input and what kind of output you expect. You can add these directly in the Advanced Settings sidebar of your selected mode.
- Input field: Shows how you’ll phrase your requests
- Output field: Demonstrates your expected AI response
- Click “Add Example” to create your first example pair
- Fill in both the input and output fields
- Add more examples by clicking “Add Example” again
Adding 2-3 examples significantly improves AI’s understanding of your needs and leads to more accurate responses.
Advanced Tip
Currently, Custom Mode doesn’t include text selection context like Super Mode. Enable this by editing your mode’s JSON config file - just back up first and use a simple text editor like TextEdit or VS Code.Locate Your Modes Folder
Open Finder and navigate to ~/Documents/SuperWhisper/modes/ to access your modes folder
Find Your Mode File
Use Quick Look (press Space) on JSON files to preview and identify your mode by its “name” field
Enable Selection Context
Open the JSON file and change “context_from_selection” from
false to trueRestart to Apply
Save your changes and restart Superwhisper to activate the selection context feature
Text Selection Context in your custom instructions, as covered in Prompting Tips.
Unlike other modes, Custom Mode isn’t limited to text formatting. Combine context-awareness with your instructions to create powerful, specialized workflows tailored to your needs.