Skip to main content
OpenComic is highly customizable, allowing you to tailor the reading experience to your preferences. Customize themes, keyboard shortcuts, tap zones, visual filters, and more.

​
Themes and appearance

OpenComic uses Material Design with multiple color themes.

​
Color themes

Choose from a variety of color palettes:

Blue

Classic blue theme (default)

Red

Vibrant red theme

Pink

Pink theme

Purple

Purple theme

Deep Purple

Deep purple theme

Indigo

Indigo theme

Light Blue

Light blue theme

Cyan

Cyan theme

Teal

Teal theme

Green

Green theme

Light Green

Light green theme

Lime

Lime theme

Yellow

Yellow theme

Amber

Amber theme

Orange

Orange theme

Deep Orange

Deep orange theme

Brown

Brown theme

Gray

Neutral gray theme

Blue Gray

Blue gray theme

​
Changing themes

1

Open theme settings

Navigate to Settings → Theme or click the theme icon in the sidebar.
2

Select color

Choose your preferred color theme from the palette.
3

Apply instantly

Theme changes apply immediately throughout the app.

​
Light and dark modes

Each theme supports both light and dark variants:
  • Light mode: Bright backgrounds, dark text
  • Dark mode: Dark backgrounds, light text (better for night reading)
  • System mode: Automatically matches your OS theme preference
Click the moon/sun icon to toggle between light and dark modes.

​
Theme customization

OpenComic’s Material Design themes include:
  • Primary colors: Main accent colors throughout the interface
  • Secondary colors: Supporting colors for highlights
  • Surface colors: Background and card surfaces
  • Surface tinting: Subtle color overlays on surfaces
  • Proper contrast: Ensures text readability in all modes

​
Keyboard shortcuts

Customize keyboard shortcuts for every action in OpenComic.

​
Shortcut sections

Shortcuts are organized by context:
Library and folder browsing shortcuts:
  • Reload library (F5)
  • Search (Ctrl+F)
  • Search with filter (Ctrl+G)
  • Previous chapter
  • Next chapter
  • Go back (Mouse3)
  • Go forward (Mouse4)

​
Customizing shortcuts

1

Open shortcuts settings

Navigate to Settings → Shortcuts.
2

Select section

Choose Browse, Reading, or OPDS shortcuts.
3

Find action

Locate the action you want to customize.
4

Record new shortcut

Click the shortcut field and press your desired key combination.Supported keys:
  • Letters: A-Z
  • Numbers: 0-9
  • Function keys: F1-F12
  • Arrows: ArrowUp, ArrowDown, ArrowLeft, ArrowRight
  • Modifiers: Ctrl, Alt, Shift, Meta (Cmd on Mac)
  • Mouse: Mouse3 (back), Mouse4 (forward)
  • Special: Space, Enter, Escape, Tab, etc.
5

Save

Shortcuts save automatically and take effect immediately.

​
Shortcut format

// Single key
"F5"

// With modifier
"Ctrl+F"
"Alt+Shift+D"

// Mouse buttons
"Mouse3"  // Back button
"Mouse4"  // Forward button

// Special combinations
"Ctrl+Shift+ArrowLeft"

​
Manga mode inversion

In manga mode (right-to-left reading), certain shortcuts automatically invert:
  • ArrowRight ↔ ArrowLeft
  • KeyD ↔ KeyA
This ensures natural navigation in manga mode.
Enable “Invert tap zones in manga” to also flip tap zone directions in manga mode.

​
Tap zones

Tap zones let you navigate by clicking different areas of the screen.

​
Zone grid

The reading area is divided into a 3×3 grid: 
┌──────────┬──────────┬──────────┐
│  Top     │  Top     │  Top     │
│  Left    │  Center  │  Right   │
├──────────┼──────────┼──────────┤
│  Center  │  Center  │  Center  │
│  Left    │  Center  │  Right   │
├──────────┼──────────┼──────────┤
│  Bottom  │  Bottom  │  Bottom  │
│  Left    │  Center  │  Right   │
└──────────┴──────────┴──────────┘
Each zone can trigger a different action.

​
Click types

  • Left click: Primary navigation
  • Right click: Context menu or custom action
  • Middle click: Custom action

​
Default tap zone configuration

Default left-to-right configuration:
ZoneLeft ClickRight Click
Left sidePrevious pageContext menu
CenterToggle UIContext menu
Right sideNext pageContext menu
TopPrevious pageContext menu
BottomNext pageContext menu

​
Customizing tap zones

1

Open shortcuts settings

Navigate to Settings → Shortcuts → Tap Zones.
2

Select zone

Choose a position on the 3×3 grid.
3

Choose click type

Select left, right, or middle click.
4

Assign action

Pick an action from the available options:
  • Next page / Previous page
  • First page / Last page
  • Next comic / Previous comic
  • Toggle UI
  • Fullscreen
  • Magnifying glass
  • Create bookmark
  • Context menu
  • Custom shortcuts

​
Disabling tap zones

If you prefer not to use tap zones: 
config.disableTapZones = true
This prevents accidental actions when clicking on images.

​
Mouse wheel actions

Customize mouse wheel behavior:
  • Scroll pages: Wheel scrolls through pages
  • Zoom: Ctrl + wheel zooms in/out
  • Pan: Wheel pans when zoomed

​
Image filters and adjustments

Apply visual filters to enhance or modify comic images.

​
Available filters

Adjust image brightness:
  • Range: -100% to +100%
  • Default: 0% (no change)
  • Useful for: Dark scans, night reading

​
Advanced filters

Apply color tinting to grayscale images:
  • Adds color tone to monochrome comics
  • Customizable hue and intensity
  • Preserves grayscale gradients
Enhance edge definition:
  • Makes details more crisp
  • Useful for: Soft or blurry scans
  • Adjustable intensity

​
Applying filters

1

Open image settings

While reading, open Settings → Image Adjustments.
2

Adjust sliders

Move sliders to adjust each filter:
  • Changes preview in real-time
  • Combine multiple filters
  • Fine-tune to your preference
3

Save settings

Filter settings save per comic or globally based on your preference.

​
Per-comic settings

OpenComic can remember different settings for each comic: 
readingPagesConfig: {
  brightness: 10,
  contrast: 5,
  saturation: -20,
  sepia: 0,
  invertColors: false
}
Or apply globally to all comics.

​
Gamepad customization

Customize gamepad button mappings for controller-based navigation.

​
Default gamepad controls

  • X: Reload
  • LB: Previous chapter
  • RB: Next chapter

​
Customizing gamepad

1

Connect gamepad

Connect your game controller to your computer.
2

Open gamepad settings

Navigate to Settings → Shortcuts → Gamepad.
3

Map buttons

Assign actions to each button:
  • Face buttons: A, B, X, Y
  • Shoulder buttons: LB, RB, LT, RT
  • D-pad directions
  • Analog sticks
  • Start/Select/Menu buttons

​
Reading preferences

​
Page layout presets

Save custom page layout configurations:
  • Single page
  • Double page
  • Webtoon/scroll
  • Custom combinations

​
Transition effects

Slide

Pages slide horizontally or vertically

Scroll

Smooth continuous scrolling

Rough turn

Quick instant page changes

Smooth turn

Animated page transitions

Fade

Fade between pages

​
Margin and spacing

Customize page margins:
  • Horizontal margins: Space between double pages
  • Vertical margins: Top/bottom spacing
  • Adjustable: Increase/decrease with shortcuts

​
Advanced customization

​
Configuration file

Advanced users can directly edit the configuration file: 
{
  "theme": "material-design",
  "themeColor": "blue",
  "readingManga": false,
  "readingWebtoon": false,
  "readingDoublePage": false,
  "readingImageInterpolationMethodUpscaling": "lanczos3",
  "readingImageInterpolationMethodDownscaling": "lanczos3",
  "readingAi": {
    "upscale": {
      "active": false,
      "model": "realcugan",
      "scale": 2,
      "noise": 0,
      "autoScale": true,
      "maxMegapixels": 3.0
    },
    "descreen": {
      "active": false,
      "model": "opencomic-ai-descreen-hard-lite"
    },
    "artifactRemoval": {
      "active": false,
      "model": "opencomic-ai-artifact-removal-lite"
    }
  },
  "disableTapZones": false,
  "invertTapZonesInManga": true,
  "systemNightMode": false
}

​
Per-page configuration

Create different settings for different page types: 
readingPagesConfig: {
  single: { /* settings for single pages */ },
  double: { /* settings for double pages */ },
  webtoon: { /* settings for webtoon scrolling */ }
}

readingShortcutPagesConfig: {
  single: { /* specific shortcuts for single pages */ },
  double: { /* specific shortcuts for double pages */ }
}

​
Reset to defaults

If you want to reset customizations:
1

Open settings

Navigate to Settings.
2

Find reset option

Look for “Reset to defaults” in the relevant section.
3

Confirm reset

Confirm you want to restore default settings.
You can reset:
  • Individual shortcuts
  • All shortcuts in a section
  • Theme colors
  • Image filters
  • All settings (full reset)

Explore more

Return to essentials for basic features and getting started

Build docs developers (and LLMs) love

Get started for freeTalk to us