npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

wavez-discord-presence

v1.5.1

Published

Local bridge that shows your currently playing wavez.fm tracks/status as Discord Rich Presence.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

flutedsfluteds

Keywords

wavezdiscorddiscord-rpcrich-presenceuserscript

Readme

Wavez Discord Presence

Show what you're listening to on wavez.fm as Discord Rich Presence, track, artist, DJ, room, listener count, and a Join the room button so friends can drop in.

The image displays a music player interface. It shows that someone is listening to "Ghostlight" by Skeler and DJ yngk. The current time is 01:56 out of 02:29. The background features city skyscrapers, and the text "SKELER" is overlaid on the image. The song is noted as being played on "Move It! - Brasil," with 6 listeners currently tuned in.

Discord's Rich Presence only speaks over a local IPC socket, which a browser tab can't touch. So this ships as two halves: a userscript that reads the wavez page, and a small bridge that relays what it reads into the Discord desktop app.

Install

You'll need Node.js and a userscript manager, preferably Tampermonkey. There's no Discord app to register and no config to fill in.

  1. Install the userscript via going to wavez-discord-presence.user.js. Your userscript manager will offer to install it.

  2. Run the bridge in the terminal. One command, nothing to clone or install.

npx wavez-discord-presence

Terminal recording of the bridge: npx installs wavez-discord-presence, it starts listening on port 6969, connects to Discord, then logs each track as it plays and clears the presence when playback pauses.

  1. Open wavez.fm and join a room. Your presence updates on its own.

Leave the bridge running in the background. It's the only piece that can actually reach Discord, if you close the terminal, your presence disappears.

From source

If you'd rather not use npx, or you want to edit the bridge, clone it and run it directly:

git clone https://github.com/fluteds/wavez-discord-presence
cd wavez-discord-presence
npm install
npm start

Same thing, just pinned to the code in front of you rather than the published package. config.json goes in this folder.

To install it globally, so wavez-discord-presence works as a command from anywhere:

npm install -g wavez-discord-presence

Config

The defaults work as-is. Skip this unless something clashes.

Copy and rename config.example.json to config.json (it's gitignored) and set only the keys you care about. Every key also has an env var, which wins over the file.

| Key | Env var | Default | | --- | --- | --- | | appId | DISCORD_APP_ID | The shared wavez.fm presence app | | port | PORT | 6969 | | largeImage | LARGE_IMAGE | Wavez logo | | sourceBadges | SOURCE_BADGES | false | | lastfmKey | LASTFM_API_KEY | Unset, iTunes is used instead |

appId, the Discord application your presence appears under. The bundled default is a public identifier, not a secret. Application IDs ship inside every Discord client, so sharing one is expected and safe. Point this at your own Discord app only if you want a different app name on your profile.

largeImage, fallback artwork when a track has no thumbnail. Either an image URL, or the key of an asset you uploaded under Rich Presence → Art Assets in your Discord app.

port, change only if 6969 is taken. If you do, update BRIDGE at the top of the userscript to match; both ends have to agree.

sourceBadges, what the small corner badge on the artwork shows. Off by default, so it's the wavez logo with wavez.fm on hover. Set it to true and it becomes a YouTube or SoundCloud badge instead, or a Live indicator for live streams.

lastfmKey, where cover art comes from. wavez only sends the video thumbnail, so the real album cover is looked up by artist and track. Leave this unset and iTunes answers, no key and no setup, which is what npx gives you. Set it and Last.fm is asked first, falling back to iTunes when it has no cover, which is worth doing if you listen to anything iTunes doesn't stock. Grab a key from Last.fm's API page; it's free and instant. The bridge prints which source it's using on startup.

Troubleshooting

Nothing shows up in Discord

Check the terminal. ✅ connected to Discord means it found the desktop app, if it says Discord is unreachable, you're likely on the web version of Discord, which has no IPC socket and cannot work.

The bridge says port 6969 is busy

It's already running in another terminal. Either use that one, or set PORT and update BRIDGE in the userscript to match.

The bridge never logs anything when anyone plays a track

The userscript isn't reaching it. Open the browser console on wavez.fm and look for [wz-presence] lines; bridge unreachable means the bridge isn't running, and no lines at all means the userscript didn't load.

Presence is stuck on an old track

The bridge clears it after 40s without a heartbeat. If wavez is still open, the userscript has probably stopped, reload the tab.

License

MIT