Ravenpost

A small app for your computer that sends what your World of Warcraft addons saved to the sites you use them with. A few seconds after you log out or /reload, your character's journal is on your phone.

The latest release, free and open source. Windows on ARM · every release

macOS 11 or later (Apple silicon and Intel). Windows 10 or 11.

"Windows protected your PC"

You will probably see this the first time you open Ravenpost. It doesn't mean Windows found anything wrong with it. It means the file isn't code-signed: signing needs a paid certificate tied to a company or a verified person, and a new app without one has no reputation with Microsoft yet. Ravenpost is made by one person in their spare time, and the certificate isn't there yet.

Windows: SmartScreen

  1. If your browser says the file isn't commonly downloaded, keep it. In Edge: the ... menu next to the download, Keep, Show more, Keep anyway.
  2. Open it. When Windows warns you, click More info.
  3. Click Run anyway.

Windows remembers, and won't ask again for this file.

Windows 11: Smart App Control

If Smart App Control is on, it may block the file outright, with no "Run anyway". It judges each file through Microsoft's cloud, and an unsigned file it hasn't seen before can be refused.

Either open an issue and say which file was blocked, so a new build can be made, or turn Smart App Control off in Windows Security, under App & browser control. Think twice about the second: it protects you from other apps too, and on some versions of Windows it can't be turned back on without reinstalling Windows.

macOS

Open the zip and move Ravenpost to your Applications folder first, then open it from there.

macOS says it can't check Ravenpost for malicious software. Close the message, open System Settings (System Preferences before macOS 13), then Privacy & Security, scroll down and click Open Anyway next to Ravenpost. On macOS 14 or older, right-clicking the app and choosing Open does the same.

Check it yourself

Ravenpost's whole source is on GitHub, MIT licensed. Every download on this page is built by GitHub Actions from that source, in public, and attached to the release by the same run. You can read what each release changed on its release page, or build it yourself.

What it sends, and what it never does

It sends

  • To hearthtale.app: each character's name, realm, race, class and sex, the journal Hearthtale wrote at logout (with the language it is written in), and the link code if you typed one with /ht link. The addon's raw records stay on your computer.
  • To wow-locker.app: the WoWLocker addon's saved file, as it is.
  • When you sign in with Battle.net: your Battle.net id, your BattleTag and the characters on the account, to hearthtale.app and, if you linked it, wow-locker.app. That's how they know which characters are yours.
  • To the addons' shared game database, only if you say yes: with "Share what you see" ticked in Hearthtale, Lorekeeper's Codex, Yonder or Second Wind, and Ravenpost linked with Battle.net, what the game showed you of the world. Quest texts, creatures, what characters say, what a creature dropped. It helps the addons cover World of Warcraft: Forever's new content sooner. The Battle.net link counts you as one voice when players' games disagree.
  • Once a day, to its own inbox: a random number made for this install (the inbox keeps only a hash of it), its version, your system and which sites you've linked. That's how Ravenpost's users are counted, nothing about you or your characters.
  • Every six hours, it asks GitHub whether a newer version is out. Nothing of yours goes with the question.

It never

  • sends any file but these.
  • keeps your Battle.net account. The database stores only a hash of it.
  • sends your chat, or a line naming another player.
  • puts your name, class or race in what you share with the database.
  • reads any other addon's saved files. Of the rest of the game folder, it only looks at which of these addons are installed, and which accounts and characters have saved files.
  • runs what an addon saved. Saved files are read as data, never executed.
  • touches the game itself, injects anything into it or reads its memory.
  • updates itself. When a new version is out, it tells you, and you download it.
  • shows system notifications. What it sent is in its own window.

You can leave out a character or a whole game account in its window. Its Settings page has a Diagnostics text to paste into an issue: it names no character, no account and holds no token.

The addons it works with

Ravenpost finds Classic Era, World of Warcraft: Forever and Forever's beta by itself, and shows which of these addons are installed in each game.

Ravenpost sends something only for Hearthtale, WoWLocker, and, if you share what you see, Lorekeeper's Codex, Yonder and Second Wind. For the others, it just shows they're installed.

Questions

Is it safe?

It reads a few files your addons already wrote in your game folder and sends them over HTTPS to the sites listed above, plus your Battle.net sign-in if you make one, the daily count and the update check. Its source is public, every line. The warning you see is about who signed the file, not about what's in it.

Does it touch the game?

No. It never runs inside the game, changes its files or reads its memory. It only reads the saved files World of Warcraft writes to disk when you log out or type /reload, the same files a backup tool would copy. Blizzard's rules are Blizzard's to state, and we don't speak for them.

Why isn't it signed?

A certificate Windows trusts costs money every year, and Ravenpost is one person's project. Until it's signed, the steps above get you past the warning, and the source is there to check.

What does it need?

On Windows 10 or 11, Microsoft Edge WebView2 for its window. It comes with Windows 11 and with an up-to-date Windows 10. On macOS, nothing beyond macOS 11. It's a small download because it uses your system's own web view instead of bundling a browser.

Do I need it to use the addons?

No. Every addon works in the game without it. Ravenpost is only for reading Hearthtale's journal on your phone, seeing your characters on WoWLocker, or sharing what you see.

Does it keep running when I close it?

Yes, from the menu bar on macOS or the tray on Windows, so it can send your files at your next logout. Quit it from that icon. With "Open Ravenpost at login" on in its settings, it starts there quietly.

How do I remove it?

Quit it from the menu bar or the tray, then delete it: on macOS, drag Ravenpost from Applications to the Trash. On Windows, delete the .exe you downloaded. If you turned on "Open Ravenpost at login", turn it off first in Ravenpost's settings.

Something's wrong. Where do I tell you?

Open an issue on GitHub, with the Diagnostics text from Ravenpost's Settings if it starts.

Keep the ravens flying

Ravenpost and the addons are free. If you like them, a coffee on Ko-fi helps pay for the sites the ravens fly to.