Skip to content

README.md

Latest commit

 

History

History
214 lines (141 loc) · 7.69 KB

README.md

File metadata and controls

214 lines (141 loc) · 7.69 KB

TRIM

Download Windows macOS Linux

A launcher for Windows, macOS, and Linux. Spotlight-ish, but with AI.

On Windows and macOS, Alt+Space (Option+Space on Mac) toggles the bar. Change it in /settings. On Linux, TRIM can't register a global shortcut; you bind one in your window manager (see below). Frosted acrylic on Windows 11, otherwise it stays out of your way.

App Search

Features

App Search

Start typing to find apps. Results sort by how often you use them, and fuzzy matching works (vsc finds Visual Studio Code).

  • Windows: Start Menu shortcuts + Microsoft Store / UWP apps
  • macOS: .app bundles from /Applications, /System/Applications, and ~/Applications
  • Linux: .desktop entries from ~/.local/share/applications, /usr/share/applications, Flatpak, Snap

AI Chat

Prefix with ? for Gemini Flash or ?? for Gemini Pro. Answers use live Google Search and render Markdown with syntax highlighting, LaTeX, and copy buttons on code blocks.

Conversations stick around when you hide the window. Backspace the prefix to start a new chat.

AI Chat

Python Execution

The AI can install packages, run scripts, and return real output, not just plots. Force Code makes every query run Python instead of letting the model guess.

Windows, macOS, and Linux builds can ship with a bundled Python runtime. Set TRIM_SKIP_BUNDLED_PYTHON=1 to use system Python during development.

Python Execution

File References

#filename in an AI query attaches that file as context. Text, PDFs, and images work.

File References

File Automation

The AI can read, create, edit, and delete files. Destructive changes show a diff and ask for confirmation first.

File Automation

Image Generation

Ask for an image and it shows up inline. Copy to clipboard or save from the hover buttons.

Image Generation

Math

c: runs a local symbolic engine (no API calls).

  • c: 2+2 → instant evaluation
  • c: x^2-4=0 → symbolic solving with steps
  • c: derive x^3 → differentiation, integration, factoring
  • c: sin(x) → interactive 2D plot with hover
  • c: x^2+y^2 → 3D surface plot with rotation

KaTeX rendering, collapsible steps, and an AI Explain chip if you want plain English.

If your expression has variables, they show under the result (handy for catching syn vs sin).

Calculator Function Reference

Arithmetic & Constants

Input Description Example
+ - * / ^ Basic operators c: 2^10 → 1024
% Percentage c: 200 * 50% → 100
pi π ≈ 3.14159 c: 2*pi
e Euler's number ≈ 2.71828 c: e^2

Functions (Numeric)

Function Description Example
sin cos tan Trigonometric c: sin(pi/2) → 1
asin acos atan Inverse trig c: asin(1) → 1.5708
sqrt Square root c: sqrt(144) → 12
cbrt Cube root c: cbrt(27) → 3
abs Absolute value c: abs(-42) → 42
log Base-10 logarithm c: log(100) → 2
ln Natural logarithm c: ln(e) → 1
exp Exponential (e^x) c: exp(1) → 2.71828
round ceil floor Rounding c: floor(3.7) → 3
gcd / ggT Greatest common divisor c: gcd(12, 8) → 4
lcm / kgV Least common multiple c: lcm(4, 6) → 12

Functions can be nested: c: sin(gcd(4, 5)), c: sqrt(gcd(16, 64)) → 4

Symbolic Operations

Prefix Description Example
derive / diff Differentiation c: derive sin(x) → cos(x)
integrate Integration c: integrate x^2 → x³/3 + C
factor Factorize c: factor x^2-4 → (x-2)(x+2)
expand Expand c: expand (x+1)^3
simplify Simplify c: simplify sin(x)^2+cos(x)^2 → 1

Solving

Type any equation with = and variables: c: x^2 - 5x + 6 = 0 → x = 2, x = 3

Plotting

Expressions with variables are plotted automatically:

  • 2D: c: sin(x), c: x^2 - 4 - interactive line chart
  • 3D: c: x^2 + y^2 - rotatable surface plot
  • Explicit: c: plot sin(x) / c: graph x^2

Math

3D Plot

Folder Search

f: report searches Desktop, Documents, Downloads, and any extra paths you add in settings.

Folder Search

Quick Reference

Prefix Mode Key Action
(none) App search Alt+Space (Win/mac) Toggle TRIM
? AI Flash Escape Hide
?? AI Pro Up/Down Navigate
c: Math Enter Execute
f: Folders Tab Autocomplete
/ Commands

On Linux, bind your compositor to "$APPIMAGE" --toggle (or the full AppImage path). See Install.

Install

Windows / macOS

Download from Releases:

  • Windows: run the .exe installer
  • macOS: open the .dmg and drag TRIM to Applications

Linux

Linux builds are AppImages only (no .deb or .rpm yet).

  1. Download TRIM-…-Linux-x86_64.AppImage from Releases.
  2. Move it somewhere permanent and chmod +x it.
  3. On Arch you might need sudo pacman -S fuse2.
  4. Run it once.

TRIM has to stay running for toggles to work. Autostart it hidden:

"/path/to/TRIM.AppImage" --hidden

Or turn on Launch on startup in /settings (packaged builds pass --hidden automatically).

Bind a key in your compositor:

"/path/to/TRIM.AppImage" --toggle

Hyprland example:

bind = SUPER, SPACE, exec, "/path/to/TRIM.AppImage" --toggle

Each keybind exec spins up a short helper process (AppImage mount + Electron). ~150ms before toggle on packaged builds. Normal.

Escape closes the bar. Click-away dismiss is off on Linux so tiling WMs and focus-follows-mouse don't close it accidentally. Set TRIM_LINUX_BLUR_DISMISS=1 if you want click-away back.

/settings on Linux shows your paths and copies the commands if you're already running the AppImage.

From source

git clone https://github.com/6A31/TRIM.git
cd TRIM
npm install
npm start

You'll need Node.js LTS. For AI, grab a free Gemini API key and paste it in via /settings.

Dev toggle from the repo: npx electron . --toggle (separate config from the packaged app).

Building

npm run build:win      # Windows (.exe installer)
npm run build:mac      # macOS (.dmg)
npm run build:linux     # Linux (AppImage)

Stack

Electron 41, vanilla JS (no frameworks), @google/genai for Gemini 3 Flash / 3.1 Pro, bundled Python for local code execution.

License

TRIM Non-Commercial No-Derivatives License (see LICENSE).