Selecto AI

Docs Reference

Selecto AI documentation.

Everything the app does, setting by setting. For a step-by-step tour with screenshots, read the guide.

Quick start

  1. Install Selecto AI from the Download page (Windows 10 or 11, x64 or ARM64).
  2. Select a word in any app: the bar appears above it.
  3. Dictionary, translation and AI use Online actions (Settings › AI), on by default: untick it if you want nothing sent online.
  4. For AI, pick a model: On my PC (free, private) or Online with your API key.

Step by step

The Selecto AI installer, welcome screen.
  1. Install: in your user profile, no administrator password.
  2. Options: folder and shortcuts.
  3. Meanwhile, a reminder of the essentials: select, the bar appears.
Welcome assistant, screen 1 of 3: “Welcome to Selecto AI”, bar preview, Skip or Continue.
  1. On first launch, the assistant shows the bar on a sample text.
  2. Continue: the AI level, then you are set.
  3. Skip: everything can be set later in Settings.
Welcome assistant, screen 2 of 3: “Which AI level?” None, free local AI (recommended), My provider (API key).
  1. Three choices: no AI, free local AI, or your provider with your key.
  2. When a model is ready, the assistant says so.
Notification-area icon menu: Bar active, Settings, Open the extensions folder, Quit.
  1. Bar active: turns the bar off or on everywhere.
  2. Settings.
  3. Open the extensions folder.
  4. Quit.
A word is selected; the bar appears above it.
  1. Double-click a word or drag over a passage: it gets highlighted.
  2. The bar sits right above, without taking focus.
  3. Search opens the selection in your engine.

The bar

The Selecto bar above a selected word.
  1. Search, blue dot.
  2. Cut · Copy · Paste (Cut and Paste only in an editable field).
  3. Dictionary (book) and Translate (globe), when online actions are on.
  4. AI ▾: Summarise, Explain, Rephrase, Correct.
  5. The selection stays visible under the bar.
A selected link: an Open link button is added.
  1. Text detected as a link, Windows path or e-mail adds a button after Search.
TopicBehaviour
AppearsAfter a double-click, a triple-click or a drag longer than 40 pixels, with a 75 ms delay, in any app where text can be selected. Text is read through Windows accessibility (UI Automation), otherwise through a simulated Ctrl+C, the clipboard being restored afterwards.
Does not appearIn excluded apps (by default: cmd, PowerShell, pwsh, Windows Terminal, conhost, mintty, where Ctrl+C would interrupt the program), in windows running as administrator (Windows blocks key sending from a non-elevated program), on excluded sites, and in Selecto AI’s own windows.
PositionCentred above the selection; below when there is no room; never under the pointer. Adjustable: above or below (Settings › General).
FocusThe bar never takes focus: your app stays active.
ClosingClick elsewhere or Esc.
SizeFrom 80 to 140% (Settings › General).
DisablePer app or per site (exclusions), or globally from the notification-area icon, or with the global keyboard shortcut chosen in Settings › General.
LimitsUp to 10 MB of text read, 50 KB processed; dictionary for 1 to 3 words (beyond that, translation); MyMemory translation in 500-character chunks, about 5,000 characters a day without an account; AI: at most 4,000 characters sent; search: 400 characters.
LookTranslucent indigo pill, white buttons, thin separators; the Search button has a blue dot.

Action reference

Default order, left to right. “Online” means the selected text is sent to a third-party service.

ActionShows whenWhat it doesOnline
SearchAlwaysOpens the selection in your search engine, in the default browser. Google by default; Bing, DuckDuckGo, Brave, Ecosia, Kagi, Startpage, Yahoo, or a custom address with *** in place of the text (gear next to Search, Actions tab). 400 characters at most.yes
Open linkA web address is detectedOpens the link in the default browser.no
Show in ExplorerA Windows path is detectedOpens Explorer at that path.no
Write to…An e-mail address is detectedOpens a new message to that address.no
Spelling (Abc)Editable field, misspelt wordReplaces the word with the suggestion.no
CutEditable fieldClipboard.no
CopyAlwaysClipboard.no
PasteEditable field and non-empty clipboardClipboard.no
DictionaryOnline actions on, 1 to 3 wordsPart of speech, pronunciation, 1 to 5 definitions (Wiktionary / dictionaryapi).yes
TranslateOnline actions onLanguage detected, translation to the chosen language, target-language selector (MyMemory).yes
AI ▾: Summarise, Explain, Rephrase, CorrectOnline actions on and a model configuredAnswer in the window; Rephrase and Correct replace in an editable field.local: no · key: yes

The answer window

Translation · en → fr window with Replace and Copy.
  1. Title: the action and the detected languages.
  2. The answer, then its source (here MyMemory).
  3. Change the target language.
  4. Replace writes the answer over the selection (editable field).
  5. Copy puts the answer on the clipboard.
Dictionary window for “sérendipité”.
  1. The word, its pronunciation and part of speech.
  2. Up to five definitions.
  3. The source: Wiktionary or dictionaryapi.dev.
  4. Copy (no Replace: a definition does not replace the word).
Corrected text window from the local AI.
  1. The title says the action: Summary, Explanation, Rephrasing, Corrected text.
  2. “Generated by <model>, check before replacing.”
  3. Replace, then the corrected text takes the place of the mistake.
ElementDetail
ShapeWhite card about 360 px wide, rounded corners, thin border, blue accent; never takes focus; Esc or a click elsewhere closes it.
Titles“Dictionary”, “Translation · fr → en”, “Summary”, “Explanation”, “Rephrasing”, “Corrected text”.
ButtonsReplace (blue, only if the selection is editable) and Copy.
LoadingIndicator and “Searching…”.
AI note“Generated by <model>, check before replacing.”
No model“No model configured” with the buttons “Install AI on my PC” and “Use an online service”.
Network errorMessage and an “Open in browser” button.

Settings

Open the settings from the notification-area icon. Four tabs.

General

Settings, General page: navigation rail on the left, setting cards.
  1. The rail: General, Actions, AI, About.
  2. The badge shows the installed version.
  3. Automatic appearance on each selection.
  4. Global keyboard shortcut (turns Selecto on or off).
  5. Excluded apps and sites: Manage…
  6. Bar size, 80 to 140%.
  7. Position: above or below the text.
  8. Apply saves; Reset returns to the defaults.
  • Automatic appearance of the bar on selection.
  • Global keyboard shortcut, chosen by you (the combination is captured in the field). It does not open the bar: it turns Selecto AI on or off, like the “Enable” item in the icon’s menu. Ctrl, Alt, Shift or Win plus a key A–Z, 0–9 or F1–F12. Windows may refuse a shortcut already taken (message in the log).
  • Excluded apps and excluded sites.
  • Bar size, from 80 to 140%.
  • Position: above or below the selection.
  • Start with Windows.

Actions

Settings, Actions page: each bar action with its switch and arrows.
  1. Search for an action in the list.
  2. Enable or disable each action.
  3. Reorder with the arrows.
  4. Search’s gear: the search engine.
  • Action list: enable, disable, reorder.
  • Search engine (gear next to Search): Google, Bing, DuckDuckGo, Brave, Ecosia, Kagi, Startpage, Yahoo or a custom address with ***.
  • JavaScript extensions: enable, disable, reorder, open the folder.

AI

Settings, AI page: online actions, languages, AI model ready.
  1. Online actions: Dictionary, Translate and AI (on by default, can be turned off).
  2. Translation, fallback and dictionary languages; optional MyMemory e-mail.
  3. The AI model in place (here qwen2.5:3b, on the PC).
  4. Change the model or test it.
  • Online actions (on by default, can be turned off here and from the welcome screen): Dictionary, Translate and AI send the selected text to third-party services (MyMemory, Wiktionary, Wikipedia) or to your model.
  • Translate to: French, English, Spanish, German, Italian, Portuguese, Dutch or Arabic; the source language is detected. Fallback language (English by default) when the text is already in the target language. Dictionary: Automatic, French (Wiktionary) or English (dictionaryapi.dev).
  • MyMemory e-mail, optional: raises the translation limit (personal data).
  • AI model: On my PC, Online service, or Later.

About

Settings, About page: version, MIT licence, source code.
  1. Edition: free.
  2. Installed version.
  • Version: shown here. Update: “Check for updates” button (Site edition).
  • Licence: MIT, text and source code on GitHub. No key, no account.
  • Extensions folder (.js files), Open button.
  • Uninstall local AI: removes the engine installed by Selecto AI and its models.

AI on my PC

Settings › AI › On my PC. Three steps, no terminal, no administrator rights.

Step 1 of 3: AI engine. “Install the AI engine (210 MB)” button, free, no administrator rights. Step 2 of 3: Model. Light ≈ 1.0 GB, Balanced ≈ 1.9 GB, Powerful ≈ 3.4 GB, “Recommended for your PC”. Downloading the model: 13%, 136 MB of 990 MB, 28 MB/s, 31 s left. Step 3 of 3: Ready ✓, model qwen2.5:1.5b. Done, Change and Test buttons.
  1. AI engine, 210 MB
  2. Pick a model
  3. Download
  4. Ready ✓
The real flow in Settings › AI, one click, no terminal.
StepDetail
1. AI engine“Install the AI engine (210 MB)”: an official portable build of Ollama, installed in the app folder (%LOCALAPPDATA%\SelectoAI\ollama), local address http://127.0.0.1:11434, never reachable from the network. An Ollama you installed yourself is left alone.
2. ModelRecommended for your PC’s memory: Light qwen2.5:1.5b (≈ 1.0 GB, fast), Balanced qwen2.5:3b (≈ 1.9 GB, good in French), Powerful gemma3:4b (≈ 3.4 GB, best in French and for long texts). A “More powerful” choice is folded away.
3. ReadyDownload with progress (you can close the window, it continues in the background), then “Ready ✓ — model: …” with Change and Test buttons.
RemoveSettings › About › Uninstall local AI › Uninstall…: removes the engine installed by Selecto AI and all its models, after confirmation, showing the space freed. To only change model: AI tab › Change.
FoldersEngine and models in %LOCALAPPDATA%\SelectoAI\ollama (app, models, download subfolders).

Online AI

Online service: provider, API key, Continue.
  1. Pick the provider in the list.
  2. Paste your API key (“Get a key” opens the provider’s site).
  3. Continue: the model is ready.

Settings › AI › Online service: pick the provider, paste your API key (“Get a key” button to the provider’s site), Continue. Providers: OpenAI, Anthropic, Gemini, Mistral, Groq, DeepSeek, xAI, Together, OpenRouter. You pay the provider directly; the selected text is sent to them for each AI action.

Privacy

DataGoes toWhen
Selected textMyMemoryTranslate
Selected textWiktionary / dictionaryapiDictionary
Selected textYour search engineSearch
Selected textYour AI providerAI actions with an API key
Selected textNowhere: processed on your PCAI actions with the local model
Usage, habits, appsNowhere: no telemetry—

Details in the privacy policy.

Free and licence

  • Free: no price, no subscription, no account, no key.
  • Licence: MIT. You may use, study, modify and redistribute the software, including commercially, keeping the copyright notice.
  • Source code: github.com/warezfr/selecto-ai.

Licence text

Troubleshooting

ProblemCheck
The bar does not appearSelecto is running (notification-area icon); the app or site is not excluded; automatic appearance is on (Settings › General).
No Dictionary, Translate or AI buttonCheck that “Online actions” is ticked in Settings › AI (on by default). Dictionary only shows for 1 to 3 words.
“No model configured”Settings › AI: install AI on your PC or paste an API key.
Windows blocks the installerSmartScreen, while the installer is unsigned: see the Download page (steps and checksum).
Network error in the windowThe online service is not answering: “Open in browser” button, or try again later.
No bar in a terminal or an administrator windowExpected: terminals are excluded by default (Ctrl+C would interrupt the program) and Windows blocks key sending to an elevated window.
The shortcut does nothingCheck that a combination is saved in Settings › General. If another program already uses it, Windows refuses it (see selecto.log). Reminder: it turns Selecto AI on or off, it does not open the bar.
Log%APPDATA%\SelectoAI\selecto.log: ignored extensions, refused shortcut, network errors.
Anything elseWrite to us with the Selecto version (Settings › About), your Windows version and, if possible, a screenshot.

Extensions

An extension is a .js file dropped into the extensions folder (%APPDATA%\SelectoAI\Extensions, Open button in Actions and About, “+ Add” in Actions, or the icon’s menu). One file = one action, added after the built-in buttons. Extensions are reloaded at launch and when the settings open; they are enabled, disabled and reordered in Settings › Actions. Two examples, uppercase.js and word-count.js, are copied into the folder while it is empty.

File structure

// ==SelectoExtension==
// @name MAJUSCULES
// @identifier com.exemple.upper
// @icon AA
// @regex /[a-z]/
// @requirements text, paste
// @apps chrome.exe, code.exe
// ==/SelectoExtension==
selecto.pasteText(selecto.text.toUpperCase());
FieldRole
@nameRequired. Action name (Actions tab, button tooltip).
@identifierRequired, unique.
@iconOptional. Short text shown on the button (otherwise the name).
@regexOptional. Expression tested against the first 50 KB of the selected text (the /…/ are stripped); the button only shows when it matches. 200 ms timeout.
@requirementsComma-separated list: text; paste (editable field only); nopaste (read-only only); url (selection contains a link); path (a Windows path).
@appsAllow-list of executables (.exe optional, case-insensitive).

The older ==SelectBarExtension== header is still accepted. An unknown requirement, an invalid expression or an incomplete header makes the extension ignored; the reason is written to selecto.log.

The selecto object

MemberEffect
selecto.textThe selected text (truncated to 50 KB).
selecto.copyText(s)Puts s on the clipboard.
selecto.pasteText(s)Pastes s over the selection (simulated Ctrl+V, clipboard restored).
selecto.openUrl(u)Opens u in the default browser (http, https, mailto) or in Explorer (file); only during the button click.
selecto.showText(s)Shows a small text bubble near the pointer, about 8 s.

Jint engine (ES5 and basic ES6 JavaScript), 5 s maximum per run, call stack limited to 200, no network or file access. The script returns nothing: everything goes through these methods.

Requirements

  • Windows 10 or Windows 11, x64 or ARM64 (.NET 8 program). French interface.
  • Local AI: about 210 MB for the engine, then 1.0 to 3.4 GB per model; the recommended model depends on the PC’s memory.
  • Online actions: an Internet connection.

Where the files are

FolderContents
%APPDATA%\SelectoAIsettings.json, excluded-apps.json, excluded-sites.json, selecto.log (log) and the Extensions folder.
%LOCALAPPDATA%\SelectoAIollama (engine and local AI models).

On first launch, settings from the former name “SelectBar” are copied automatically. To quit: notification-area icon › Quit.