This is a BitBar plugin (supporting both SwiftBar and xbar) that displays unread watchlist entries on MediaWiki wikis.
- Install SwiftBar or xbar.
- If you're unsure which to install, I recommend SwiftBar, as this plugin has been tested with it.
- If you have Homebrew, you can also install with
brew install --cask swiftbar
orbrew install --cask xbar
.
- Install Rust.
- If you have Homebrew, you can also install with
brew install rust
.
- If you have Homebrew, you can also install with
- Install the plugin:
cargo install --git=https://github.com/fenhl/bitbar-mediawiki-watchlist --branch=main
- Create a symlink to
~/.cargo/bin/bitbar-mediawiki-watchlist
in your SwiftBar/xbar plugin folder. Call it something likebitbar-mediawiki-watchlist.30s.o
, where30s
is the rate at which the plugin will check for notifications. - At
~/.config/bitbar/plugins/mediawiki-watchlist.json
, create a JSON file containing the following fields:"wikis"
, an array of objects, one for each wiki whose watchlist you want to display, each with the following fields:"displayName"
: a name for the wiki that will be displayed in the menu."apiUrl"
: The wiki's “api.php” URL, which can be found on theSpecial:Version
page of the wiki, in section “Entry Point URLs”."indexUrl"
: The wiki's “index.php” URL, which can be found on theSpecial:Version
page of the wiki, in section “Entry Point URLs”."username"
: Your username on the wiki."watchlistToken"
: Your watchlist token, which can be found on the “Watchlist” tab of theSpecial:Preferences
page.
- If you're using SwiftBar, the plugin should now appear in your menu bar. If it doesn't appear automatically, or if you're using xbar, refresh by opening a menu and pressing ⌘R.