GDTuber ![](https://github.com/quellus/GDTuber/raw/main/Assets/GDTuber.png)
Made by Quellus and Code807
GDTuber is a dynamic PNGTuber software made in Godot. It supports voice-reactive avatars, accessories, and a save/load system for multiple profiles.
Features
- Support for voice reactive on-screen objects with visual changes or movement (bouncing)
- Support for several individual on-screen objects
- Support for dynamic position, scale, and rotation of on-screen objects
- Audio threshold/sensitivity settings
- Designed for simple OBS integration using transparency or chroma key
Instructions
- Select your microphone from the
Input Device
drop down menu at the top.
- Press the
+
button to create a new avatar
- Use the
Change Image
button to set an image for the avatar/object (more information in the Image Setup section)
- Use the bottom row of icons to activate the gizmo
- left click to move the object on screen
- right click to rotate the object on screen
- scroll to scale the object on screen
- Add additional avatars or accessories with the
+
button
OBS instructions
- Create a
Game Capture
source
- Set
Mode
to "Capture specific window"
- Set
Window
to the GDTuber window
- Select
Allow Transparency
at the bottom
Image Setup
Currently, GDTuber supports single-image avatars. If an avatar has a blinking animation, it should take up the bottom half of the image. If an avatar has a talking animation, it should take up the right half of the image. Below is an example avatar featuring both a talking and blinking animation.
Contributing
Thank you for considering contributing to our project! We appreciate your interest and support. To make the process as smooth as possible, please follow the guidelines below.
Prerequisites
Getting Started
- Fork the repository: Click the 'Fork' button at the top right corner of the repository page.
- Clone your forked repository:
git clone https://github.com/quellus/GDTuber.git
- Navigate to the project directory:
cd REPO_NAME
- Create a new branch for your feature or bugfix:
git checkout -b feature-or-bugfix-name
Making Changes
- Open the project in Godot (version 4.2.2).
- Make your changes or additions in the Godot editor.
- Test your changes thoroughly to ensure they work as expected.
Committing Your Changes
- Add your changes:
git add .
- Commit your changes with a descriptive commit message:
git commit -m "Description of changes"
Pushing Your Changes
- Push to your forked repository:
git push origin feature-or-bugfix-name
- Create a Pull Request:
- Go to the GDTuber repository.
- Click on the 'Pull requests' tab.
- Click the 'New pull request' button.
- Select the branch you pushed your changes to in your forked repository.
- Click 'Create pull request' and fill out the required information.
Code Review
Your pull request will be reviewed by one of our team members. We may ask for changes or clarifications. Please be responsive and address any feedback as soon as possible.
Additional Notes
- Adhere to the existing code style and conventions.
- Write clear, concise commit messages.
- Include comments and documentation as necessary.
- Ensure your changes do not break existing functionality.
Community Guidelines
- Be respectful and considerate of others.
- Provide constructive feedback.
- Keep discussions focused and on topic.
Thank you for your contributions!
For any questions or additional help, feel free to open an issue or contact us on our Discord server.
Attribution
Contract icon by Delapouite under CC BY 3.0
Cog icon by Lorc under CC BY 3.0
Download
![](http://jessemillar.github.io/available-on-itchio-badge/badge-bw.png)