Basic‐Usage - Life-Experimentalist/NovelSynth GitHub Wiki
Basic Usage Guide
🎯 Getting Started with NovelSynth
This guide covers the essential features and daily usage patterns of NovelSynth.
🎮 Interface Overview
Main Popup Window
Access via the browser toolbar icon:
- Quick Actions: Primary feature buttons
- Settings: Configuration and API keys
- Feature Toggles: Enable/disable specific features
- History: Recent enhancements and results
Floating Panel
Always accessible quick-access panel:
- Location: Bottom-right corner of web pages
- Quick Features: One-click access to primary functions
- Collapsible: Minimize when not needed
- Context-Aware: Shows relevant features for selected content
📖 Core Features
1. Content Enhancement
Purpose: Improve grammar, style, and readability of text
How to Use:
- Select Text: Highlight content you want to enhance
- Activate: Click "Enhance" in popup or floating panel
- Review: Enhanced text appears in results panel
- Apply: Choose to replace original or keep both versions
Best For:
- Draft writing or rough content
- Non-native language text
- Improving clarity and flow
- Quick grammar fixes
Example:
Original: "The book was really good and I liked it alot."
Enhanced: "The book was excellent, and I thoroughly enjoyed it."
2. Content Summarization
Purpose: Create concise summaries of long articles or chapters
How to Use:
- Select Content: Highlight article, chapter, or long section
- Summarize: Click "Summarize" feature
- Choose Length: Select brief, moderate, or detailed summary
- Save: Export summary for later reference
Best For:
- Long articles or research papers
- Chapter summaries for novels
- Meeting notes or documentation
- Quick content review
Example:
Original: [1000-word article about AI developments]
Summary: "Recent AI advances focus on efficiency and safety,
with major breakthroughs in language models and autonomous
systems. Three key trends emerge: reduced computational
requirements, improved reasoning capabilities, and enhanced
human-AI collaboration."
3. Content Analysis
Purpose: Provide insights about themes, structure, and quality
How to Use:
- Select Content: Choose text for analysis
- Analyze: Click "Analyze" feature
- Review Insights: Read generated analysis
- Export: Save analysis for reference
Best For:
- Understanding story themes
- Analyzing writing quality
- Academic text review
- Content structure insights
Analysis Types:
- Literary Analysis: Themes, characters, style
- Technical Analysis: Clarity, accuracy, structure
- Readability: Grade level, complexity metrics
- Sentiment: Emotional tone and mood
🌐 Website-Specific Usage
Fiction Websites
Archive of Our Own (AO3)
- Auto-Detection: Recognizes story content automatically
- Chapter Processing: Enhance entire chapters
- Series Tracking: Remember enhancement preferences
- Export Options: Save enhanced versions
FanFiction.Net
- Story Integration: Works with story reader
- Author Notes: Skip enhancement of metadata
- Review Integration: Enhance review text
- Mobile Support: Works on mobile interface
Wattpad
- Reading Mode: Integrate with Wattpad's reader
- Comment Enhancement: Improve comment quality
- Story Discovery: Analyze story descriptions
Technical Sites
Documentation Sites
- Code Preservation: Skip code blocks during enhancement
- API Docs: Improve example descriptions
- Tutorial Enhancement: Clarify instructions
- Multi-language: Handle technical terminology
Stack Overflow
- Question Improvement: Enhance question clarity
- Answer Optimization: Improve answer readability
- Code Comments: Generate better code explanations
News and Articles
Medium, Substack, Blogs
- Article Summarization: Quick article overviews
- Key Points: Extract main arguments
- Fact Checking: Highlight claims for verification
- Reading Time: Estimate reading duration
⚙️ Customization Options
Prompt Customization
Editing Prompts:
- Open Settings: Go to Settings → Custom Prompts
- Select Feature: Choose feature to customize
- Edit Template: Modify the prompt template
- Test Changes: Use test content to verify
- Save: Apply custom prompt
Prompt Variables:
{content}
: The selected text{contentType}
: Type of content (novel, news, etc.){length}
: Desired output length{style}
: Preferred writing style
Example Custom Prompt:
Enhance this {contentType} content by improving clarity
and flow while maintaining the original tone. Focus on:
- Grammar and punctuation
- Sentence structure
- Word choice
- {style} writing style
Content: {content}
Content Type Settings
Automatic Detection:
- Novel Sites: Enhanced for creative writing
- Technical Sites: Preserves technical accuracy
- News Sites: Focuses on factual clarity
- General: Balanced enhancement approach
Manual Override:
- Force Type: Override automatic detection
- Custom Rules: Set rules for specific domains
- Save Preferences: Remember settings per site
AI Provider Preferences
Per-Feature Configuration:
- Enhancement: Choose best provider for style improvement
- Summarization: Select provider for concise summaries
- Analysis: Pick provider for detailed insights
Model Selection:
- Quality vs Speed: Balance between result quality and response time
- Cost Optimization: Choose cost-effective models
- Feature Matching: Match model capabilities to features
🚀 Productivity Tips
Efficient Workflows
Quick Enhancement:
- Keyboard Shortcuts: Set up custom shortcuts
- Floating Panel: Keep panel open for rapid access
- Batch Processing: Select multiple paragraphs
- Auto-Apply: Set preferences to auto-apply enhancements
Content Creation:
- Draft Enhancement: Write rough drafts, then enhance
- Progressive Refinement: Multiple enhancement passes
- Style Consistency: Use same prompts for consistent style
- Quality Control: Always review AI suggestions
Best Practices
Text Selection:
- Complete Thoughts: Select full sentences or paragraphs
- Context: Include enough context for accurate enhancement
- Clean Selection: Avoid selecting UI elements
- Optimal Length: 100-2000 words works best
Feature Usage:
- Right Tool: Use appropriate feature for the task
- Iterative: Make multiple small improvements
- Review: Always review AI output before accepting
- Backup: Keep original text when making major changes
Performance:
- Internet: Ensure stable connection
- API Limits: Monitor usage to avoid rate limits
- Cache: Use cached results when possible
- Efficiency: Process related content together
📊 Monitoring Usage
Usage Statistics
- Daily Usage: Track features used per day
- API Consumption: Monitor token usage
- Success Rate: View enhancement success metrics
- Response Times: Track AI response performance
Quality Tracking
- Enhancement Quality: Rate AI improvements
- Accuracy: Track factual accuracy for summaries
- Relevance: Measure analysis relevance
- User Satisfaction: Personal quality ratings
❗ Common Issues and Solutions
Selection Problems
Issue: No text selected Solution: Ensure text is highlighted before activation
Issue: Mixed content selected Solution: Select only the content text, avoid UI elements
Feature Issues
Issue: Poor enhancement quality Solution: Try different AI provider or adjust prompts
Issue: Slow response times Solution: Check internet connection and API status
Browser Issues
Issue: Extension not loading Solution: Refresh page or restart browser
Issue: Floating panel not visible Solution: Check if panel is minimized or check extension permissions
🔗 Advanced Usage
Power User Features
- Batch Processing: Process multiple selections
- Custom Shortcuts: Set keyboard shortcuts
- API Switching: Dynamically switch between providers
- Export Options: Multiple output formats
Integration Options
- Reading Apps: Works with web-based reading applications
- Note Taking: Integrate with note-taking workflows
- Content Management: Bulk content processing
- Quality Assurance: Systematic content review
🔗 Next Steps
- Content Enhancement - Detailed enhancement guide
- Supported Websites - Full site compatibility list
- Troubleshooting - Solve common problems
Need Help? Visit our FAQ or Issues for assistance.