Automatically adds users as buddies when they send you a private message or when you download from them. Pair it with "Buddies Only" file sharing so access is granted the moment someone reaches out.
- Set your file sharing to "Buddies Only"
- Put "Message me for access" in your user bio
- When someone messages you, they're automatically added as a buddy
- They now have access to your files!
- Auto-buddy on message - Instant access via private message
- Auto-buddy on download - Adds users you download from as buddies automatically
- Welcome messages - Customizable auto-reply to new buddies
- Activity logging - Track all buddy additions
- Blacklist support - Block specific users from triggering the plugin
See INSTALL.md for full installation instructions, including one-click install scripts.
The plugin includes the following configurable options:
- Buddy on download — toggle whether completing a download adds that user as a buddy (on by default)
- Welcome message — text sent when a user is added via private message (leave empty to disable)
- Blacklist — comma-separated usernames that will never trigger auto-buddy
Nicotine+ → Settings → Shares → Downloads
Set "Who can download from me" to "Buddies"
Nicotine+ → Settings → User Info → User Info
Add: "Message me for access to my files"
- Enable "Auto Buddy" plugin
- Set welcome message (optional)
- Nicotine+ 3.0 or higher
- Python 3.6+
Once installed, the plugin will automatically:
- Monitor incoming private messages
- Monitor completed downloads
- Skip users already on your buddy list
- Skip users on your blacklist
- Add qualifying users as buddies
- Send a welcome message to message-triggered buddies (if configured)
- Log all buddy additions
[Auto Buddy] Added buddy 'MusicLover42' - Reason: Received private message
[Auto Buddy] Added buddy 'VinylCollector' - Reason: Downloaded file: /Music/Pink Floyd/Wish You Were Here.flac
MIT License
Contributions are welcome! See CONTRIBUTING.md for guidelines.