PyNGtuber - a really personalizable PNGtuber App
A downloadable Vtuber Software for Windows and Linux
A highly customizable PNGtuber app
Make your streams more dynamic with animations, GIFs, controllers, mouse tracking and more.
š„ Open-source and completely FREE to use!
Features
- Store multiple faces and models separately so you can make a new avatar and keep all your expressions
- Editor mode with lots of settings and highlighting
- Change settings in bulk
- 3 Talking states (not talking, talking and screaming)
- Animation customization, fine tune it however you like
- Mouse and controller tracking
- Keyboard and Midi Shortcuts
- Twitch integration (Keys must be provided)
- Per layer animations and settings
- HTML, CSS and JS Code editor
- GIF support!
- Face Tracking!
ā ļø Sadly, face tracking is not available in the windows version yet. :(
- If you really want it, try using the source code version,
it's more involved but it works!
And so much more!
Support this project!
You can make a donation right here or support me by other means:
- Donating to my Ko-Fi.
- Donating to my Streamlabs.
- Helping me buy a new computer in Throne.
- Following me on social media.
- Joining my Discord.
Tutorials
Coming soon-ish!
Contributions
If you're interested in contributing to this project or checking out the code, feel free to get involved. Contributions are highly appreciated!
Feedback
Your feedback and ideas are valuable. If you have suggestions, issues or questions, please don't hesitate to reach out.
Credits
- Art by Chereverie, this software was inspired by her Picrew.
- Face tracking by Mostafa Nafie with Head-Pose-Estimation.
Download
Click download now to get access to the following files:
Development log
- BugFix Update! v1.10.2Sep 14, 2024
- [Fixed] First time open crash!Aug 21, 2024
Comments
Log in with itch.io to leave a comment.
Hi there! I'm loving this so far! I'm having one issue though. I'm finding that the mouse tracking and talking animations aren't working through OBS but its moving in the program. Is there a way to fix this issue? I'm on windows 10. Thanks!
Oh yeah, sorry about that, youāre using the Browser Source Capture, right?
If you use the same URL on Chrome or another browser, it works as intended but i have to rework it because it loses connection thanks to OBSās browser, it is slow af
So yeahā¦ i need to think on another way to achieve the same result.
Until then, use window capture and chroma-keying, if you wanna hide the UI to the viewer, toggle āsecond window for captureā and re-start the software
Hello! I'm trying to build this from source on Ubuntu 22 and I'm having some trouble with PyQt6. Can you tell me what version of Linux you're able to run it on? I'm suspecting I might need to upgrade. Thank you!
I currently use Arch Linux, afaik glibc is outdated in the current version of Ubuntu, so thatās an issue there :/
That would explain it. Thank you!
Is it possible for me to add my own avatar pngs into the program? I'm a little confused if there is.
Yes! you can!
You can create categories and add images to it:
Hi, I'm starting to use this and it's really great! One question, is it possible to turn off whatever is making my avatar get smaller when it goes into talking mode? I think I've been through every menu and I can't find it.
your avatar becomes smaller? thatās weird, not the default behavior, you could check the animations below the microphone capture widget, there might be a setting changed, by default the animation when talking is āfloatyā and when screaming is āshakingā
I figured it out...I had set my body size to 700x700 (which is what I originally exported my png as) but the "size and position" animations for the body when talking and screaming were set to size 600x600. I think it was applying the size change even though I had no animation selected specifically on the body and even had the "size and position" box unchecked. Maybe a bug? I ended up re exporting my png at 600x600 because it was easier than resizing all the pieces everywhere in the app. Suggestion: in a future release add a way to change the "default" size that gets applied everywhere.
Other feedback:
I have been seeing the same "The system cannot find the path specified: 'Assets'" error that other commenters have mentioned. When I went to the "%AppData%\PyNGtuber\Data" folder in file explorer, the Assets folder was there. I was worried about removing it entirely because I didn't want to lose the work I had already done on my model. However, I waited a few minutes and opened the program again, and it magically worked. I've replicated the open program > see error > close and wait > open program > it works flow multiple times over a few days. Without fully debugging it, my best guess is that a background process could be "using" that folder (like microsoft onedrive or a virus scanner) and preventing pyngtuber from accessing it temporarily.
I am also seeing the occasional lag between the app and obs, same as other commenters mentioned.
I love the ability to bind toggles to key combinations! One of the main reasons I wanted to switch png apps is because the one I was using wouldn't let you set toggles to multiple keys, so I would be changing my expression when typing, using in game key shortcuts, etc.
I'm excited to see how this app evolves and what features you add!
Oh yeah! that issue of the ānot enabled animation still has animationā is fixed in the next version, sorry for taking a while on that, iām doing too much at the same time lmao.
Interesting, that would explain a lot, iām a linux user so i donāt use Windows that much apart from a windows computer that i use as a server, there might be something that is making use of it, i would have to do a whole investigation thoā¦
You mean the lag between the app and OBS when using the browser source? yeah thatās something on OBS that makes it slow and i need to find another way to get the same result, if you open it on a browser it justā¦ worksā¦ so yeah, iāve been struggling with that one lul
Thank you for your support, your insight is really helpful! Ʊ.Ʊ
Hii there, I really love this Png Tuber Maker, but unfortunately the program will no longer open on my PC ... I selected the real camera capture option and that made the viewer vanish and each time I try to redownload it will no longer open for me...I use Windows 11, if you could help me fix the issue I would really appreciate it!
Hey! so sorry, thereās an issue with the camera tracker in the windows version, you can go to %AppData%\PyNGtuber\Data, search and edit the file settings.json, search the value āmouse trackingā and set it to ādisabledā or āmouseā if you want to use mouse tracking!
That should fix it!
Iām working on an alternative way of face tracking, be patient Ʊ.Ʊ
Commenting here because I want to use this but I'll be waiting for a couple reasons:
1. For some reason, the audio for this video isn't working for me? I don't know if that's intentional because I can hear other videos on reddit and on places like youtube just fine.
and 2. I would like to be reminded of this for if/when you or someone posts tutorials when it comes to putting your own model in here! I'm updating my model and I currently use PNGTuber+. This is a bit confusing for me without a visual tutorial showing me how of some sort, since I'm much better with visuals and audio then just... figuring it out via trial and error :').
Hey! yeah the video doesnāt have audio, it was intended as a demo and just that, Iāll be making a full video about it with audio and all.
Tutorials and documentation are coming, but itās gonna take a while, since Iāve been focusing on code mostly (big update coming!), soā¦ sorry for that š , iāll comment to you here once thereās tutorials and i might add something to signal about it on the software itself!
Thank you so much for letting me know! All of that would be greatly appreciated <3!!
(I duel boot windows and arch, so that's why I've commented here before) I ran this on windows 10, but when it ran fine yesterday and it gave me an error message (listed below), it worked fine then, but when I try to open it today it gave me the same error message, but it won't open any fixes? Here's the error message that was listed:
Traceback (most recent call last):
File "main.py", line 2844, in <module>
File "main.py", line 2835, in main
File "main.py", line 853, in __init__
File "Core\imageGallery.py", line 547, in __init__
FileNotFoundError: [WinError 3] The system cannot find the path specified: 'Assets'
Okay, this is weird, somehow your āAssetsā folder in ā%AppData%\PyNGtuberā got deleted, i wonder how that might have happenedā¦
You could copy the folder manually from the package folder, there should be 4 folders, Assets, Models, Data and Viewer
I completely deleted it and reinstalled it, it no longer opens anymore
Hey!, what did you delete? if you delete the folder %AppData%\PyNGtuber it should reset the app
so I orignally deleted the entire file, I reinatalled it through itch, then i did what you said and deleted the data folder. it now gives me the error:
Traceback (most recent call last):
File "main.py", line 176, in <module>
File "main.py", line 136, in update_directory
FileNotFoundError: [WinError 3] The system cannot find the path specified: 'C:\\Users\\NyxTh\\Downloads\\PNGtuber\\Data'
try re-downloading it, looks like youāre missing files in the package, i would recommend doing it manually tbh
That is, I can't launch the program.
I don't know why. At first it opened normally. I'm getting dressed and wearing skins. Then suddenly the program closed itself. And now I can't open the program again. Is there a solution?
Hi!, it just wonāt open? doesnāt show an error window or something?
Do you know if you changed a setting that made it crash? I mean this as a way to diagnose what happened so i can fix it. If you know iāll be so grateful! and iāll be able to help keep your data because:
As a last resort, you can always delete the folder %AppData%/PyNGtuber and that should reset the app!
Hey! I seem to be having an issue where the model just flickers a lot, I'm wondering if there's anything I can do to resolve that. Love the program, thanks for making it!
Hey! sadly thatās not an issue i can fix :/ it happens on some windows systems and idk why tbhā¦
Maybe i should report it upstream to the toolkit devsā¦
But, I may have two solutions, they are not greatā¢ļø but itās something:
Go and try going to āSettingsā then to āCaptureā and use a browser source and either add it to OBS or open it on a webbrowser, either should work
[Best result but a bit more complex] Go to āSettingsā then to āCanvasā and click on the button below that says āEnter canvas editorā, you should be able to see a debug URL at the top, open that address on Chrome and then click con āviewer.htmlā, that should also get you something you can capture.
Sorry for the inconvenience :/
Aw, darn. No worries! I'll give these a shot, thanks for the reply!
So i'm having this issue where i opened the app the very first time i downloaded it no problem, but now it wont. it loads for a bit and then does nothing. i've tried deleting it a couple different times and tried both the windows and source downloads at separate times but it still wont open. please help, i really wanna be able to use it.
Hey, sorry for this, dunno why itās happening, try to delete the folder in %AppData% named PyNGtuber, that should reset the app, if you know why it started to happen it would be of so much help!
I'm trying to download this, but I'm having trouble figuring out the command, could I have some help? I use arch BTW
Hey, what version are you trying to download?
the linux version, I guess
with the linux version all you need is to double click the binary to open it, no command needed!
Iām on Ubuntu 22.04 with KDE. I tried installing PyNGtuber from the zip but it complained that it couldnāt find libc.so.6 version
GLIBC_ABI_DT_RELR. So I thought āNo problem, just run the long pip install command from the download pageā. When I did that it failed to compile pyaudio because the portaudio dev files were missing. Installing those for some reason needs me to uninstall WINE. So I installed portaudioās dev files, ran the pip command and it worked, then I installed WINE again but the error message I get from PyNGtuber is unchanged. Note that even while portaudioās dev files are still installed the error message is the same, so removing the dev files only disables me from compiling portaudio, not running it. On my laptop I can update to 24.04 (and will soon do that), but on my big PC (where I create my videos because it has a decent GPU) I cannot do that because the packages are messed up so the upgrade fails and many packages are missing from the repos and I simply donāt want to tackle that issue right now so it stays on 22.04.Is there anything I can do to make PyNGtuber work?
Hey you could try using distrobox? it might help you with your packagesā fragmentation until you can fix it
I mean I can try that but first Iāll try it on my laptop next weekend after updating it to Ubuntu 24.04. Iāll wait until the weekend with that because Iām simply a bit overcautious and want to take a full backup of my entire disk beforehand so I can act as if nothing happened incase somehting goes wrong, by just rolling it back.
Iāll report back after that and tell you if it works on the newer LTS or not.
Yeah the GLIBC thing is an issue with Debian based distros atm, iirc they are on the version 2.35 and the one that PyQt6 needs is the 2.36, the current version on Arch (my system) is 2.40, honestly iām quite surprised that itās that outdated.
if you do the command āldd āversionā in the terminal you should see your current version (Ex. ldd (GNU libc) 2.40).
Yes, itās version 2.35 (Ā©2022) for me, probably because Ubuntu 22.04 was released in 2022 and only gets security updates from there to remain as stable and predictable as possible.
Interesting then that I can use PyQt6 just fine for one of my projects that Iām writing on my laptopā¦
I just tried running PyNGtuber in that projectās venv but it still complains about the same missing version. Could it maybe be an environment variable that isnāt set correctly?
Weāll see in two or three days if upgrading helps. Otherwise Iām also going to try to install Arch (been interested in it for a while anyway) and see if I can properly use that despite all my ubuntu muscle-memory.
Huh tbh i assumed that PyQT6 was the culprit because i have no way to test it, then it might be a different library that is asking for it, the error doesnāt give more information than āGLIBC_ABI_DT_RELR not foundā
Hey! sorry that this is happening
Could you be more specific on whatās the issue when editing? that way i can fix it!
Sorry for the late reply, I re-downloaded it and it worked perfectly.
Nice!
Really like the look of this! Had a bit of bother with it crashing when trying to save a new face till I found the expressions section at the bottom of the settings bar. Also had a bit of a thing where memes kept showing up while in a different collection haha. Will keep poking around but the variety of things here is great!
Hey! thanks for reporting this!
I will look into it and update as soon as i can!
Ʊ.Ʊ
Def going to be on the look out for face tracking on windows!
If you install the āSource Codeā version, it works there, the problem is that it refuses to be packaged, thatās what iām figuring out lol
Opened first try, but didn't work on the second attempt to open the software, it runs really smoothly and seems to work okay if I don't make any major changes (switching from voice to face tracking, turning on or off production mode, etc.) but I can live with those, I'm on windows 11 so that may be a reason why, but if you could explain it in detail as to what I should do, I would really appreciate it wholeheartedly! Don't let the haters tell you otherwise, your software is really a lifesaver... I'll be sure to tell my followers where I got my pngtuber/vtuber avatar while I'm attempting to make my own vtuber model, so I'm eternally thankful... Sorry for the rambling, you've done an amazing job making it :D
Oh, the first attempt it was creating the files that needed to work, takes a while to load sometimes lol.
The face tracking is not available on Windows :(, and it doesnāt replace the voice tracking, it replaces mouse tracking, all it does is make the avatar mimic your head rotation!
The performance mode toggle isnāt working or do you mean another thing?
And thank you! dw it being my first published software, some issues are bound to happen and salty people will get mad, but eh, itās been really good to see the general reception! Ʊ.Ʊ
I might see if uninstalling and reinstalling will work (Btw, good stream earlier today, I only speak English but you seem pretty cool :D)
Nope, it didn't work... Uh, this is what came up when I tried to open it, if you could help me out it would be greatly appreciated
HELP! (Pyngtuber problem :( ) {Ā”AYUDA! (Problema de Pyngtuber :( )} : u/YumiThePedoBuster (reddit.com)
Hey, to fix this go to %AppData% and delete the folder āPyNGtuberā, that should reset the software!
sorry that this is happening, iāll check why!
alr, thanks
will do when I have a chance
Nope... Still didn't work, oh well, ran great when I first used it and is still a really great software tho :D
Hey, could you send me the whole error code? that way i can check it!
I wanted to figure that stuff out. Thank you, program is working as intended now
Iām glad!
Uploading a fix now so it (hopefully) doesnāt happen again!
this is the worst itch io product i ever used, it is the most laggy trash peice of shit software ive ever laid my eyes upon. not even a 60 year old pc filled with ashes compares to this ass. it was laggy, it deleted my character twice and the customization was trash in general. the mic tracking didnt work at all either. this is a DISGRACE TO PNG TUBERS AND VTUBERS ALIKE.
do not download this
Hey, so sorry youāre having issues, you could have asked for me to solve them, youāre not telling me how and why something happened so i canāt fix them.
if you could be more especific about the issues youāre having, iāll make sure to fix them.
P.S. the audio, thereās something about some PCs that donāt like PyAudio, if you go to settings, you can change it to SoundDevice, maybe that will fix the issue.
Liking it! Having some trouble with OBS on Widows though: when I capture it as a browser source using the link in the Capture section of Settings, the version of the character in OBS is slow to react/update to voice levels and mouse tracking. The preview looks fine in the program window, but the OBS visual takes multiple seconds to update where it is looking and what state the mouth should be in. However, the eyes blink without any problem, and therefore much more often than the rest of the character animates. I was wondering if you knew any work arounds or notice if I'm doing something wrong? I've included a video I recorded in OBS to show what I mean.
Thank you for your time! I hope you continue to work on this project I really like it. ā„Hi, sorry for this, yes, iāve noticed this recently, what seems to happen is that the OBS browser source loses connection with the software so it stops receiving the update signals and then reconnects and updates.
Iāll have to do something different, iāll be fixing it tomorrow, maybe in stream lol.
Awesome! I'll try to catch your stream, good luck and have fun! ā„
I think I managed to break it. While testing it out I did notice a few issues. One issue is that it does take a good couple of minutes to boot up. However, the biggest bug I found(which is an error on my part!) Is that I got too nosy and curious. I use windows and my dumbass decided to try checking the face tracking. To which it crashed and...now it crashes on start up.
and I need help to fix that as I basically managed to break it. You warned us and I messed up. This is why poptarts have cooking instructions.
Hey!, to fix it go to %AppData%\PyNGtuber\Data and edit the file settings.json, search the value āmouse trackingā and set it to ādisabledā or āmouseā if you want to use mouse tracking!
The option showing up is not something i expected, so itās also on me lol, iāll fix it
Yooo! Thank you so much! That immediately fixed it! And hey, it all comes with the territory. At least one of us found that bug! Aside from that, I really adore the interface and everything and look forward to seeing this grow! and thank you again for the help.
Looks awesome! Can you share more about the Twitch integration options/abilities? Maybe provide a tutorial? ā„
Coming soon! I have to make full documentation lmao
An issue with the version 1.10.0 that didnāt allow the software to open for the first time has been fixed, just download the new version!
This is really awesome but you should really formally credit the artist and make sure they allow you to use their art here: https://picrew.me/en/image_maker/100365
Oh dear, this was not intentional, iāll add it now, i contacted her to be able to add it for others to use, this is a miss on my part, sorry!
Fixed!