opentrench
Getting started
1 · Install 2 · Discord 3 · Telegram 4 · Channels 5 · Using it
Help
Troubleshooting Ask on Discord

Getting started

About ten minutes end to end. Install the app, connect the accounts you already have, pick the channels you care about.

01Install

  1. Download the latest build from GitHub releases: the .dmg on a Mac, the Setup .exe on Windows.
  2. Mac: open the dmg and drag opentrench to Applications. The build is signed and notarized, so it opens like any app.
    Windows: run the installer. It isn't code-signed yet, so SmartScreen warns once: click More info → Run anyway.
  3. Open opentrench. Updates are checked on start and installed from inside the app.

02Connect Discord

opentrench talks to Discord through a small plugin inside your own Discord app, loaded by Vencord. It reads the channels you watch and sends for you using Discord's own functions, so to Discord it is simply you using Discord. No token is pasted or stored anywhere.

Vencord loads third-party plugins only from a source build, so the steps install a few developer tools first. Once. Discord has to be open for the Discord side of the feed to work.
  1. Install the tools. Open Terminal (⌘-Space, type Terminal) and paste each line, pressing Return after each. The first one shows a dialog: click Install. 
    xcode-select --install
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.zshrc
fnm install 22 && fnm use 22
npm install -g pnpm
  2. Get Vencord and add the plugin. 
    cd ~/Documents
git clone https://github.com/Vendicated/Vencord
cd Vencord
pnpm install --frozen-lockfile
mkdir -p src/userplugins
git clone --depth 1 https://github.com/frogeth/opentrench /tmp/opentrench
cp -r /tmp/opentrench/vencord/opentrench-bridge src/userplugins/
  3. Build and inject. When asked which Discord to patch, pick the one you use and confirm. 
    pnpm build
pnpm inject
  4. Turn it on. Quit Discord fully (⌘Q) and reopen it. User Settings → Vencord → Plugins → find OpentrenchBridge and switch it on.
  5. Done. Open opentrench: the discord pill in the top bar turns green within a few seconds and ⚙ → Accounts shows your name.
  1. Install the tools. Open PowerShell (Start, type PowerShell) and paste each line, pressing Enter after each. Close and reopen PowerShell after the second line. 
    winget install --id Git.Git -e
winget install --id OpenJS.NodeJS.LTS -e
npm install -g pnpm
  2. Get Vencord and add the plugin. 
    cd $HOME\Documents
git clone https://github.com/Vendicated/Vencord
cd Vencord
pnpm install --frozen-lockfile
mkdir src\userplugins -Force
git clone --depth 1 https://github.com/frogeth/opentrench $env:TEMP\opentrench
Copy-Item -Recurse $env:TEMP\opentrench\vencord\opentrench-bridge src\userplugins\
  3. Build and inject. When asked which Discord to patch, pick the one you use and confirm. Allow it if Windows asks. 
    pnpm build
pnpm inject
  4. Turn it on. Quit Discord fully (tray icon → Quit Discord) and reopen it. User Settings → Vencord → Plugins → find OpentrenchBridge and switch it on.
  5. Done. Open opentrench: the discord pill in the top bar turns green within a few seconds and ⚙ → Accounts shows your name.
Built before copying the plugin? Run pnpm build again in the Vencord folder and restart Discord. The plugin folder must sit at Vencord/src/userplugins/opentrench-bridge.

Already using a token?

Nothing breaks. Your feed keeps reading through the token; sending on that path is off. Once the plugin connects, opentrench switches to it and closes the token session. Then remove the token in ⚙ → Accounts → Discord.

03Connect Telegram

Telegram uses your own account through Telegram's official API, which Telegram allows. It needs an API id and hash, which takes a minute.

  1. Go to my.telegram.org and log in with your phone number and the code Telegram sends.
  2. Open API development tools. Any app title and short name (say opentrench), leave the rest, Create application. Copy the api_id and api_hash.
  3. In opentrench, ⚙ → Accounts → Telegram: paste both, Save credentials.
  4. Enter your number in international format (+15551234567) → Send code. The code arrives in your Telegram app, not by SMS. Enter it, and your two-step password if you have one.

The telegram pill turns green and stays logged in across restarts.

04Add channels

  1. Click the round + at the bottom of the left rail.
  2. Pick Discord or Telegram, browse your servers and chats, tick the ones to watch. Click a name first to preview its recent history.
  3. Each server and chat becomes an icon in the rail. Drag to reorder. Click one to focus on it, click ★ to get back to everything.

05Using it

The terminal
  • All Calls: one card per token, newest call first. Gold 1st for a first call, a 🔥 count when several chats called it, market cap at the call and the multiple since. Click the address to copy it.
  • All Chats: the raw messages, read bottom-up. Every contract becomes a token strip with a live chart. Click a message's chat chip to open that channel.
  • Pings: the @ button in the top bar. Everyone who mentioned you, with the messages before and after, jump-to-chat and reply.
  • Drill-down: click a token's picture, or right-click any contract → Open token. Candles on a market-cap axis with every caller pinned.
  • Columns: the + at the right end adds one: calls, chat, Top Callers, Cove, Salpha or J7, scoped to any channels, with filters and its own alert sound. Drag the grip to reorder, the edge to resize.
  • Favorites: ⋯ next to a name → Favorite caller. They get a crown and their first calls ping you.
  • Bots: ⚙ → Feed → Bots decides which bots show, which count as calls, and which may ping you.
  • J7: paste your J7Tracker session id in ⚙ → Accounts and add a J7 column. Star an account to get pinged when it tweets.

Troubleshooting

  • The discord pill stays red. Is Discord open, and is OpentrenchBridge switched on in Vencord's plugin list? If it isn't in the list, the build didn't include it: check the folder path, run pnpm build again, restart Discord.
  • Vencord isn't in Discord's settings. pnpm inject didn't patch the Discord you run. Run it again and pick the right one.
  • Discord updated and Vencord stopped loading. Run pnpm inject again in the Vencord folder.
  • Different port. If opentrench's web page isn't on 3210, set the port in the plugin's settings (Vencord → Plugins → OpentrenchBridge → gear).
  • Updating the plugin. When release notes mention it: in the Vencord folder, copy the plugin again, pnpm build, restart Discord.
  • Is this allowed? Client mods sit outside Discord's terms. Vencord has a very large user base and Discord hasn't banned for it. A self-bot, a separate program with your token, is what Discord's detection targets, which is why opentrench moved away from it.