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:

  1. Select Text: Highlight content you want to enhance
  2. Activate: Click "Enhance" in popup or floating panel
  3. Review: Enhanced text appears in results panel
  4. 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:

  1. Select Content: Highlight article, chapter, or long section
  2. Summarize: Click "Summarize" feature
  3. Choose Length: Select brief, moderate, or detailed summary
  4. 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:

  1. Select Content: Choose text for analysis
  2. Analyze: Click "Analyze" feature
  3. Review Insights: Read generated analysis
  4. 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:

  1. Open Settings: Go to Settings → Custom Prompts
  2. Select Feature: Choose feature to customize
  3. Edit Template: Modify the prompt template
  4. Test Changes: Use test content to verify
  5. 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:

  1. Keyboard Shortcuts: Set up custom shortcuts
  2. Floating Panel: Keep panel open for rapid access
  3. Batch Processing: Select multiple paragraphs
  4. Auto-Apply: Set preferences to auto-apply enhancements

Content Creation:

  1. Draft Enhancement: Write rough drafts, then enhance
  2. Progressive Refinement: Multiple enhancement passes
  3. Style Consistency: Use same prompts for consistent style
  4. 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

Need Help? Visit our FAQ or Issues for assistance.