Tool:Unwatchlist
 Unwatchlist
| |
|---|---|
| Website | https://unwatchlist.toolforge.org |
| Description | Spring cleaning for your watchlist. |
| Keywords | watchlist |
| Author(s) | Chlodtalk |
| Maintainer(s) | Chlod (View all) |
| Source code | GitLab |
| License | Apache License 2.0 |
| Issues | Phabricator |
Unwatchlist is a Node.js + Nuxt webserver that helps remove pages from users' watchlists.
Deployment
This tool is being deployed using the Toolforge Build Service.
Deployments are not automatic. As the Wikimedia GitLab instance develops, this may change in the future. For now, the following steps are used to deploy new versions of the tool.
Unwatchlist relies on Node.js 22, which (as of 17 September 2025) isn't supported by the 22_20240105 version of the heroku-builder image on Toolforge. You will need to run toolforge build start with the --use-latest-versions/-L parameter.
- [me@tools-sgebastion-XX]
become unwatchlist- That's pretty obvious already.
- [tools.unwatchlist@tools-sgebastion-XX]
toolforge build start -L https://gitlab.wikimedia.org/toolforge-repos/unwatchlist- Trigger a build on the Toolforge Build Service. This downloads the latest version of the repository (on
main) and performs all necessary build steps.
- Trigger a build on the Toolforge Build Service. This downloads the latest version of the repository (on
- [tools.unwatchlist@tools-sgebastion-XX]
toolforge webservice restart- Restart the webservice. In the event that the
service.manifestgot deleted or the service must be restarted from scratch, use the following command:- [tools.unwatchlist@tools-sgebastion-XX]
toolforge webservice buildservice start
- [tools.unwatchlist@tools-sgebastion-XX]
- Restart the webservice. In the event that the
- [tools.unwatchlist@tools-sgebastion-XX]
toolforge webservice logs -f- Verify that the tool is up and running.
For deployment issues, you can email wiki
chlod.net or use Special:EmailUser/Chlod.
Redis
This tool relies on a Redis job on its namespace. See Help:Toolforge/Redis#Redis containers for information on how to run the Redis job in case it ever gets destroyed.
Required environment variables
NUXT_SESSION_PASSWORD– At least 32 random characters. Used to encrypt access tokens.REDIS_PASSWORD– Redis password to use for both Nuxt and the Redis container.TOOL_OAUTH_CLIENT_ID– Wikimedia OAuth client ID from m:Special:OAuthConsumerRegistrationTOOL_OAUTH_CLIENT_SECRET– Wikimedia OAuth client secret from m:Special:OAuthConsumerRegistrationTOOL_OAUTH_START– OAuth authorization flow start URL. Usually set tohttps://meta.wikimedia.org/w/rest.php/oauth2/authorizeTOOL_OAUTH_END– OAuth access token request URL. Usually set tohttps://meta.wikimedia.org/w/rest.php/oauth2/access_tokenTOOL_OAUTH_REDIRECT_URI– OAuth redirect URI. This should behttps://unwatchlist.toolforge.org/loginon production.TOOL_TOOLSDB_USERandTOOL_TOOLSDB_PASSWORD(provided by Toolforge)TOOL_REPLICA_USERandTOOL_REPLICA_PASSWORD(provided by Toolforge)