GuruWatcher FAQ

GuruWatcher questions, answered

Plain answers to the questions buyers ask — price, setup, Discord, email, and what GuruWatcher does and doesn’t do.

GuruWatcher is a $99 one-time, self-hosted tool that watches concrete price levels from newsletters and sources you provide, then sends alerts to your Discord. It runs on your computer, never places orders, and is not investment advice.

Buying, setup & day to day

Are you Watcher Guru or watcher.guru?

No. GuruWatcher is a desktop alert tool from guruwatcher.com. It is not Watcher Guru (watcher.guru), a crypto news account. The two are unrelated. GuruWatcher watches price levels from newsletters you provide and sends alerts to your own Discord. It never places orders, and it is not investment advice.

I’m not technical — how do I use this?

Open the app and your browser shows the Control Panel. No terminal and no Python install: the macOS and Windows downloads are packaged apps, and a tray icon keeps them running. First, use the built-in sample: One-time paste, then Load sample, then Run once (safe). Then paste your Discord webhook and start Keep checking.

What exactly do I get for $99 — and is there a free trial?

One payment of $99. There is no subscription and no free trial. Right after checkout the thank-you page offers an immediate download: the macOS app (DMG, Apple Silicon), the Windows portable zip, or the source zip. The app reads your newsletter email, watches the printed price levels, and messages your Discord when a check sees a hit.

Which download should I pick — Mac, Windows, or source?

The thank-you page picks for your machine. On Apple Silicon choose the notarized macOS DMG: open it and drag GuruWatcher to Applications. On Windows choose the portable zip: extract it, run GuruWatcher.exe, and keep the _internal folder beside it. Intel Mac and Linux users need the source zip, which requires Python 3.10 or later.

Will it trade for me? Is this advice?

No to both. GuruWatcher never buys or sells anything. It is not a broker, not a signal room, and not investment advice. It only watches concrete price levels your newsletter printed and pings your own Discord when a check sees a level was reached. You make the final call, and alerts are not trade instructions.

Which newsletters does it work with? Do I need Macro Charts?

Any newsletter you subscribe to. Macro Charts is only one example. GuruWatcher is bring-your-own-sources: it reads the issues you give it through email or file drop, and RSS and Telegram are advanced CLI-only options. It does not redistribute Macro Charts or any paid newsletter. You keep the content rights for what you bring in.

How does the email connection work — will it read my whole inbox?

No. Each check pulls only new or unread mail from the folder you choose, never your whole history. GuruWatcher does not guess which sender is your newsletter, so point it at a dedicated mailbox, or use a Gmail filter that moves the newsletter into one label. Gmail needs an App password.

Can I try it without sending real alerts?

Yes. Run once (safe) = one price check right now, no Discord post. Quiet = Keep checking on a timer, still no post until you choose Live with a saved webhook. In the Control Panel, Load sample fills in an invented SPY/QQQ issue, then Run once (safe) checks prices once — nothing posts to Discord. For ongoing practice, run Keep checking in Quiet mode. Nothing posts until you intentionally choose Live with a saved webhook. Practice walkthrough: First run with a sample.

Do I have to set up email first?

No — skip email for now and start with the sample. Open the Control Panel → One-time paste → Load sample → Run once (safe). That walks the whole loop with an invented SPY/QQQ issue and needs no email, no webhook, and no pasting of a real issue. Add email auto-ingest or file drop whenever you’re ready. Practice walkthrough: First run with a sample.

What is the Control Panel?

It is a small page in your browser that runs only on your computer, usually at 127.0.0.1:8788. Open the app and the panel opens. There you paste your Discord channel webhook, connect newsletter email, load the sample issue, and start or stop Keep checking. No terminal skills are needed.

Do I need Claude, Cursor, or MCP?

No. You do not need Claude, Cursor, or MCP. The Mac/Windows app + Control Panel is the product. MCP is optional — an extra for people who already use those tools. Guide: Optional: Claude / Cursor (MCP).

Does it check automatically?

Only while Keep checking is on. By default it looks up live prices about every 5 minutes and pulls new newsletter email about every 15 minutes. You can edit both intervals in the Control Panel. When Keep checking is off, or the computer sleeps, nothing looks up prices and no Discord alerts arrive.

Where do the live prices come from?

Each Keep checking pass looks up the last traded price from free public market data (via yfinance on a normal install). It is not a brokerage stream and not the exchange official close — Discord fires on the next check after the market has moved through the level, often within a few minutes depending on your price-check interval. Crypto follows the same rule — see Watch crypto.

Do old alerts expire / fall off?

Yes. Newsletter levels typically expire after about 14 days unless a newer issue refreshes that symbol — you can change those days under Keep checking in the Control Panel. A newer claim for the same name replaces the older one (most-recent-wins). Expired or cancelled watches stop being tracked; old finished records are cleaned up after about 90 days.

Where does my data live?

On your machine, in one folder — ~/.guruwatcher (Mac/Linux) or %USERPROFILE%\.guruwatcher (Windows) for the app. Your newsletter text, config, and state stay local. Email is read from your mail server, prices are looked up from market data, and alerts go to your own Discord webhook — GuruWatcher doesn’t host your feeds or your webhook.

How do I get help?

Open the Support page and copy support@guruwatcher.com — that’s the primary way, before and after purchase. You do not need a desktop mail app. We answer within 1 business day. After you have the toolkit, a private GitHub Issues path is available on request (repo invite — not a public board), or join the Discord community (secondary).

Why not just set TradingView alerts by hand?

Because levels change almost every issue. A hand-set alert is only correct until the newsletter prints a new number — and you’d be transcribing every level yourself. GuruWatcher reads the issue, updates the levels automatically, and only pings Discord when a check sees one was reached. Still alert-only, still your sources.

How many times can I download, and what if I lose the link?

Each paid checkout allows up to 5 downloads of the Mac or Windows app and 3 of the source zip, within 7 days of checkout. Save the files. If you lose the thank-you link, email support@guruwatcher.com with your Stripe receipt and we can help. Digital goods: no refunds once the download is delivered.

Advanced

For power users. If you’re just starting, you don’t need any of this.

Can I drive it from Claude or Cursor?

Yes — MCP is optional. Setup is in the optional MCP guide. This is for advanced users who already use Claude Desktop or Cursor. You do not need it to use GuruWatcher.

Does this work on Windows?

Yes — Windows, Mac, and Linux. On Windows and Apple-Silicon Macs the packaged app needs no Python at all: download, then open the DMG (Mac) or run GuruWatcher.exe (Windows). On Windows, first run has up to three prompts: your browser may say the file "isn't commonly downloaded" — click Keep; right-click the zip → Properties → Unblock → Apply before extracting; and SmartScreen may still warn once for a new publisher — if so: More info → Run anyway. New to the three prompts? Windows first run, step by step. The portable zip is Authenticode-signed via Azure Artifact Signing. The source zip runs anywhere but needs a one-time Python install from python.org.

Why not Electron?

GuruWatcher is a Python app packaged with PyInstaller (onedir) — the runtime libraries are already bundled into the _internal folder next to the exe, so no Electron shell is needed. Electron would add a second UI/runtime layer and a second signing tree without clearing SmartScreen or browser download warnings (those are publisher reputation, which builds over time with live signed bytes — not by switching frameworks). We ship a signed onedir exe instead.

Do I need Docker?

No. Docker is an optional extra for power users who want the one-command pipeline. The launcher handles everything else. More in the setup guide.

Can it watch crypto — Bitcoin, Ethereum, or tokens?

Yes. Crypto majors from your newsletter (BTC, ETH, SOL, XRP, DOGE) are watched exactly like equity levels and priced as BTC-USD etc. Token watches are an advanced CLI-only option keyed to a chain + contract, with a DexScreener liquidity floor and a preview step before anything is written. Crypto alerts are alert-only — no orders, and never a brokerage tick stream. Step-by-step: Watch crypto.

Where do crypto prices come from?

Majors are looked up from Yahoo (via yfinance) as *-USD pairs by default. CoinGecko is an optional second source: new kits and the live operator config ship with crypto_price.enabled on, so CoinGecko is used as a failover when Yahoo fails (or first, if you prefer it). Tokens are priced from DexScreener by contract when token_watch.enabled is on (also on for new kits and live ops), and a pair must clear a $25,000 liquidity floor on the token’s chain before it can fire an alert. If nothing clears the floor, the check fails loud — no alert — rather than use a stale or wrong price.