Spice up your Roll20 chat by letting GIFs speak out your feeling instead of actual words.
Tenor20 is a Tampermonkey userscript that integrates GIF search functionality powered by the Tenor API into Roll20.
Installation
-
Install Tampermonkey:
-
Add the Tenor20 Script:
- Open Tampermonkey and select
Create a new script. - Replace the default content with the code in tenor20.user.js.
- IMPORTANT! Replace the
YOUR_TENOR_API_KEY_HEREwith your own Tenor API KEY. - Save the script.
- Open Tampermonkey and select
-
Getting a Tenor API Key:
- Go to Tenor Developers.
- Log in or sign up for a free account.
- Create an application to generate an API key.
- Copy your API key and replace
YOUR_TENOR_API_KEY_HEREin the script with your key.
-
Activate the Script:
- Toggle the script enabled in Tampermonkey.
- Go to a Roll20 game, and the "GIF" button should appear in the chat interface.
Contribution & Modification
Prerequisites
- Node.js
- A Tenor API key
Contributing
Found a bug or wants to add another feature?
- Fork the repository.
- Create a new branch.
- Submit a pull request. Or if you know my discord, simply message me, it's way easier.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Disclaimer
Although everything is made client-side, I can not guarantee that Roll20 is a-okay with this script. Using this script in Roll20 may violate the platform's Terms of Service. Roll20 does not officially support or endorse third-party scripts, and the use of this userscript could potentially result in account restrictions or bans. Therefore:
- Use this script only in private games with trusted players.
- Avoid using the script in public or official Roll20 games.
- Ensure you understand and comply with Roll20's Terms of Service.
- Use at your own risk.
Acknowledgments
- Tenor API for providing GIF search functionality.
- Tampermonkey for enabling userscripts.