Syncing/importing your legacy extension settings
When you switch from the legacy SwiftRead extension experience to the new extension experience, you will be presented the option to sync/import your legacy extension settings. When you sync/import settings from the legacy SwiftRead extension, your personalized reader configuration — including reading speed, focussettings, color scheme, and keyboard shortcuts — is brought over to the new extension reader, as best as possible. Here's how each setting translates.
Settings that transfer directly
These settings carry over as-is, or with minor clamping to fit the new reader's valid ranges.
| Legacy setting | New reader setting | Notes |
| WPM (words per minute) | Reading speed | Your reading speed transfers directly. |
| Font size | Font size | Transferred directly. The new reader enforces a minimum and maximum size, so extreme values may be adjusted slightly. |
| Focus letter indicator (on/off) | Focus Marks (on/off) | Your preference carries over directly. Focus Marks serve the same purpose—visual markers around the focus word to help guide your gaze. |
Settings that are approximated
Some legacy settings don't have a direct equivalent in the new reader. We do our best to find a close match.
Legacy setting: Chunk size (a word count, e.g. 3 words)
New reader setting: Focus Span (a visual width in pixels)
Why it's different:
The legacy reader grouped a fixed number of words together. The new reader uses a visual width instead, which adapts better to different word lengths and screen sizes. We calculate an approximate Focus Span based on your chunk size and font size. You may want to fine-tune this in the new reader's settings.
Legacy setting: Color scheme (e.g. "Beige", "White on Blue")
New reader setting: Color preset (e.g. Warm, Calm)
Why it's different:
The legacy reader had 15 color schemes. The new reader has five built-in color presets: Dark, Light, Warm, Calm, and Matrix. We pick the closest match based on background and text color. You can fine-tune colors or create custom presets in the new reader's theme settings.
Keyboard shortcuts
Keyboard shortcuts for supported actions are imported directly. The key combinations you set up will work the same way in the new reader.
Supported shortcuts
- Play / pause
- Jump back
- Jump forward
- Close reader
- Speed up / slow down
- Toggle narration
Not supported in the new reader
These shortcuts will be skipped during import:
- Reset speed
- Hide controls
- Increase / decrease words at a time
- Increase / decrease focus font size
- Toggle fullscreen
- Previous / next page
- Toggle context mode
If any of your shortcuts use unsupported key combinations, such as Alt/Option modifiers, they'll be skipped and noted on the import results screen.
What gets set automatically
The new reader is set to Focus mode after import. This is the mode closest to the legacy reader's behavior, where words were shown on screen in RSVP (rapid serial visual presentation) format.
After importing
Your imported settings take effect immediately in the new reader. Click the SwiftRead extension icon and then "SwiftRead current page" on any page to try them out. You can always adjust individual settings from within the reader.