Aseprite Audio Extension
A downloadable extension for Windows and Linux
Aseprite Audio Extension (AAE) is an external program that allows users to sync Aseprite's timeline with an audio file, making animation with audio significantly easier and faster to achieve. The tool also allows users to export video files of their animation. I made this a while ago, and hopefully it can be useful for someone!
To set it up, add the path to Aseprite.exe (can be located through Steam), and activate the extension. Both OS versions come with a README with instructions (please read them carefully for troubleshooting!)
OBSERVATIONS:
This tool has been tested on Aseprite v1.3.17 and v1.2.40 on Windows and Linux.
It does not support Libresprite, as that lacks some important scripting API properties.
Linux port was commissioned by RAINBOW DYE GAMES.
Please create a comment if you encounter an issue!
Download
Click download now to get access to the following files:
Development log
- v2.3.1 is out!2 days ago
- v2.3 and Linux support!14 days ago
- v2.2 is out!Aug 22, 2025
- v2.1 is out!Dec 24, 2024
- v2.0 is out!Nov 01, 2024
- v2.0 is almost out!Oct 28, 2024
- v1.1.1 is out!Jan 17, 2024
- v1.1 is out!Dec 25, 2023
Comments
Log in with itch.io to leave a comment.
I'M BEGGING YOUUU ADD A MUTE BUTTON PLEEEEAAAASSSSEEEEE
OKAY OKAY I’LL WORK ON IT AAAAAAAAAAAAAA
hey small issue, whenever I try and export it gets stuck. is it supposed to take long or am I doing something wrong?
Hello! Apologize for the wait! The culprit for that issue could be a variety of things, ranging from AAE, to FFmpeg, to Aseprite, so I can’t pinpoint exactly what’s going on. Reducing the canvas size or splitting the animation into multiple files can help though, as AAE scales your animation x2 before exporting, which can drastically increase export time.
Hello! I'm really glad I found this! I think I'm going to be able to get it to work, but I would like to ask if I could also commission you to make a port for Linux? This tool is extremely helpful for what I do so being able to have it for linux without wine could help me and many other developers. I know you are very busy, and this is a free tool. so im willing to pay however much you might need for you to be able to make it. Thank you very much for your time. :)
Hi there! Sorry for the late reply!
I’m really glad you liked the extension! And I do accept commissioning! As this is a business inquire (is it? I don’t know exactly?) though, is it possible we could talk through email? I’ve added contact info to my profile page. Feel free to email me so we can talk about this further.
Of course, ill send one over soon!
Okay i sent it over!
The audio is always playing in frame 1, how do I put it in from the middle? And how do I superimpose or put multiple audio?
Hello! Aseprite Audio Extension is built to manage one, full audio track, not multiple sound effects. This means that you have to do your own preprocessing of sound effects into one, single, longer audio file. If you want to offset when a sound effect plays, you’d also need to offset it within a longer audio track. I can recommend Audacity for doing this, but this is not built-in into AAE.
would it be possibly added later on? It would be nice to add in multipe sound tracks when it comes to working on the go
It’s a nice suggestion. I can look into it, but I’ve been unusually busy lately. I’ll try to include it in a future update.
If not, no worries; this isn't fault of yours by any kind, and PLEASE do not feel pressures to make it compatible!
Thanks!!!!
Hello! Unfortunately, as mentioned in this tool’s page, I couldn’t quite get this extension to work in Libresprite. This is because the way the extension connects to Aseprite has no counterpart in Libresprite.
However! Although I can’t exactly change the extension to fix this, I’ve made a previous version of it – version 1.1.1 – available. This version uses a different method to connect to Aseprite that should work just fine with Libresprite (but is less reliable overall).
This version of the extension is far less reliable, but if you’d like to try it out to see whether it works or not, I’ve made a tutorial on how to set it up.
Is it possible to use on linux?
Hello! Aseprite Audio Extension was made for Windows, as it’s the only platform I have access to. For this reason, it’d be really hard for me to make anything I can somewhat guarantee works on any other platform.
However, if you’re really interested in trying the extension, you can check out its GitHub and run it on your Linux machine via Godot; instructions are in that same link. I cannot guarantee this will work in the slightest.
This works fine when I do small files, but the second I go above 1 MB, it just doesn't load. Is there a file size limit or am I doing something wrong?
Hello! HUGE sorry for the long wait! I’ve been juggling projects and it took a while for me to get to this. Have you resolved the issue already?
If not, this might be a codec issue (as noted in other comments), so I advise trying to convert your audio to different file extensions. Do you have any more information about the files you’re trying AAE with if you’re still having trouble?
I unfortunately could not resolve the issue, my file that I'm attempting to use is a mp3 that's 1.4 MB in size. When I clip ~.5 MB off of it, it loads properly, but otherwise nothing shows up, like it loads like any other audio file would but then says there's nothing there and no audio shows up. I will try converting it to different file extensions to see if that works, thanks for the response!
I'm having troubles, whenever I press "load audio" and select the audio I want to use, nothing happens. I've tried using every audio file and none of them works. I don't know if anyone else is having this problem or if anyone knows how to fix it, but I need help
Hello! Does the extension show it loaded the audio file?
If you see the text “No file selected.” it could be that could operating system is messing with AAE. Try running the tool with administrative privileges, this could fix this issue.
Yeah, it says "no file selected" and I tried running it as an administrator and it still didn't work. It's probably just something wrong with my computer.
Hit a consistent crash with this tool... I tried to load in a mp3 exported from Davinci Resolve that synced with a gif animation (also from Davinci). This audio worked before, but one day I tried and instead of playing the audio, it screeched and crashed the extension... It did this consistently, re exporting the audio still caused it to crash. The only way I could fix it was to make changes to the audio in Davinci (add SFX for example) and export it under a different name. I don't know why it hates that particular file; the file looks fine in every other software... LUCKILY I was streaming when I hit the crash:
I started hitting the issue at about 20 minutes in. I can provide the problem audio file too if needed. Hope that helps!Hello! Thanks a ton for posting this! I still can’t believe the extension dies the moment you recommend it (pretty funny, but BIG oops on my part, sorry), but I’ve done some testing and I think I’ve found the culprit.
I tried exporting a test audio with Davinci Resolve and this resulting file crashed AAE. I’m not too sure how or why this happens, since audio loading is handled by Godot (the engine/code framework that AAE is built with), but I did find a workaround.
Reencoding the audio, that is, converting it to a different format (wav for keeping the quality) and back to mp3 fixed the issue for me. I used a local tool I have, but I imagine any online tool should work just fine too.
I’ll look more into it, and I’m glad you also suggested some quality-of-life features like saving the path to the folder. Thanks again for providing such detailed info on your issue!
Thanks so much for looking into this! Interesting that reencoding it fixes the issue, but not reexporting the audio... I guess it's an issue with how DR encodes the audio on export? Anyway I will try that. Thanks so much!
And always happy to promote a great tool :)
Thank you very much for your amazing work!
💖🙀💖
Is the source code available like asprite's is? I want to run this on mac so I'd probably manually port it.
It is! I forgot to link it here, but the entire source code is available on GitHub. I’m not sure if it works or not on other platforms without changing anything, but you’re free to try it out!
Help me
I will help you.
You got this.
Thanks tou
Audio skips quite a bit while editing but (thankfully) not after export; if I change the frame duration after it's been opened it's not registered when I export (ex: animation runs at 200mpf, I open aae and change it to 100mpf and export it's still at 200mpf) which caused a few very confused attempts at making it aligned with the music lol, despite this I really appreciate this tool as it makes a lot of things possible! thank you for this
what file type are you using for the audio? i cant get any of my audio files to work for some reason.
Hello! Thanks for trying out the extension, it means a lot to me :)
I think the issue you’re facing with the frame durations might already be fixed in the latest version, so long as you make sure to save your sprite before exporting (exporting processes the saved file, and not the selected sprite).
Yo is the Application Icon based on AsepriteRico’s thumbnail? That’s kinda peak
it seems as though the last update has broken the extension. or at least i cant install it. when locating the path to aseprite in steam i get the following error:
An error has occured while trying to write the lua script. Below is the error message:
Not Found
Hello! I’ve uploaded a new version in an effort to fix this. Could you please try it out and reply with an update?
the new version works!!! thanks so much for the speedy turn around! you rock~!
EDIT bad news i can now get it to activate but when loading files it wont recognize .wav files. and when i tried a mp3 file it played for about 2 seconds and then crashed(along with playing some terrible noises into my ears but no worries) when trying to relaunch and load the file again it wont even try and crashes immediately. again thanks for your speedy response! i hope its a problem only I'm having as this seems like a really cool tool to use.
also you should totally put a discord or email together or something that we we don't have to spam this page with bug fix requests!~ just a suggestion!
Oh! Sorry to hear that! I’m not quite sure what may be causing these issues, as audio is loaded by Godot, and not any code I wrote, but what I can recommend is either converting your audios to different extensions (as they may work nicer with Godot) or checking hardware compatibility (although I’m not too sure about that one).
As for your ideas regarding contact, that sounds pretty interesting! I’ll see if I can add any contact info here or in my profile page.
Would you consider releasing the source code of the app component? That way people could use it as a reference for their own implementation (or maybe just straight up add Linux support and PR it in)
Hello! Yeah! After quite a bit of deliberation, I’ve decided to upload the source code to GitHub. It’s available here!
Hi, I ran into the following bug:
I have a video that I'm trying to animate over in Aseprite. I exported the audio as MP4 and the visuals as a gif. When I import the gif and try to play the audio back with your plugin, the plugin starts skipping.
After some trial and error I realized that when I imported the gif, it changed the Frame time for each frame. Most of them are 40ms but many are longer or shorter. This seems to be the culprit, as I couldn't get the audio to skip any other way. I tried putting all the frames back to 100ms, which fixes the skipping but now everything is out of sync of course.
Is there are workaround or a planned fix for this? Thanks!
Hello! I’m working on a version that fixes this. The problem arises from the way the expected position the audio should be at is calculated. Until I finish polishing this future version, all I can suggest is standardizing the frame durations. Sorry for the inconvenience!
Thanks for the response! Any idea when this new version will be done? Thanks!
I’ve been juggling quite a few projects lately, but I expect AAE v2.2 to come out within a week or two.
Cool! Totally understand, not trying to put pressure on you. Looking forward to the new version! And thanks again :)
Hey, I am experiencing an issue with the application. For some reason it shows a black window whenever I open it. I saw that it could be due to my graphics card, but I can open other Godot applications just fine. I really don't know much so it could be the graphics card, but I have a feeling that it's not.
Hey there! I have a hunch as to what might be causing this issue and I’ll try looking into it as soon as I can. For the time being, I can only recommend deleting AAE and the folder “%AppData%/AsepriteAudioExtension/”, and then downloading it again.
help me
I will help you. You got this.
Hello! When i play my animation while using the extension, i noticed that sometimes a few "glitches" or "lags" occurs in the audio, later, when you export the animation based on the sync heard in the extension, and put it on any software, but with the original audio file, the same seems to go much ahead than the animation., if compared to what it's heard using the extension, the sync looks very incorrect as the animation plays. So, is there some way to fix those glitches? It might be the audio format, but i'm not very sure...
Hello! I’ll be reworking the sync system as soon as I can. For the time being, please try matching the audio up with external tools, if it’s just an offset problem. Thanks for pointing this out!
Hello!
So I'm having an issue with this extension, and that is that whenever I try and put it my Steam Aesprite path, it for some reason doesn't work. I have everything setup correctly, but when I put in the path and press the button, nothing happens. Does anybody know a solution to this? Thank you!
For reference, I used the path from Aesprite Rico's video, so I don't know if its outdated or something.
Hello! There’s a comment in this page that shows the exact steps to get the path. If these steps don’t work, try running AAE with administrative privileges. If it STILL doesn’t work, please get in contact again.
Is there any chance this could be ported to Linux? I'm trying to use this tool, but every time I input the path to Aseprite, I get a message stating Aseprite couldn't load the extension at a Windows file path (which doesn't exist on my PC as far as I'm aware)
i tried downloading this and extracting the zip file, and when i try, winrar gives me this error message:
! C:\Users\(my name)\Downloads\Aseprite Audio Extension v2.1.1.zip: The archive is corrupt
i thought maybe this was because i was using winrar, so i tried 7-zip.
same problem.
Data error : ffmpeg.exe
it would not extract the files, it seems like the executable itself is corrupt?
does this only work with the steam version?
oh hey there! I was using this extension, When I was exporting my work into and mp4 I was blank what can I use to fix this?
Hey there! If the video turned out completely black, this is likely an issue with the program not being able to save the frames temporarily so it can pack them into one single video. I’d suggest checking permissions to writing to AppData or running the tool with administrative privileges.
Thank for the info! Can you tell me how to do it? And I apologize for not responding sooner
How do you even exported it as MP4
It’s a feature the extension provides.
Hello! Sorry for the REALLY long delay, but I’ll be working on fixing this as soon as I can, along with a couple of other patches.
pls mac
Hey there! Unfortunately, this tool relies on some serious Windows wizardry with program IO to work. Reading input/output from other programs is functionality that could be ported to Mac, but as I don’t have any Mac systems at my disposal, I can’t test it out. I suggest looking into programs that let you run Windows applications in Mac (like how Vine works for Linux). Sorry for the inconvenience!
Does Godot not have an equivalent to `io.popen`? I used that for my own Love2D-based implementation.
Not natively, hence why I used Better Processes. It’s a pretty nice addon, I recommend it!
TYSM!! I remember trying to use the older version and not figuring out the setup (i have -3 brain cells), but this "new" version is so much cleaner!! I know it's been released for like 3 months but still. TY!!
When I open the .exe it's a black screen and I don't know if it's supposed to be like that. But then again I'm using windows 11 so it could possiably jusy be broken.
It works on my Windows 11 machine, so I don’t think OS is the issue at hand. This is likely an issue with Godot 4, as I’ve received complaints along the same lines on other Godot projects. I recommend checking your drivers and looking for system updates, those can sometimes fix these errors.
The command line output from running AAE via CMD (especially with the –verbose argument) could indicate what the source of the issue is, however. If you don’t mind sharing these details, it could help troubleshoot the issue.
Yeah sure, I mean I've been looking for this type of extension for years. Tho I'm not sure what you need to trouble shoot as I don't really know much about godot as I spent like 20 hours trying to make a cool fire thing and gave up. So if you need to know anything just ask I'll possibly respond within a day or so.
also safe are coiny, barfbag, gaty and needle!
its not work for me , i think i using wrong version or something (i using aseprite verison 1.3)
can you help me ?
(sorry for bad english)
Are you sure the Aseprite path was set up correctly?
It should work on versions that include script support.
The process listed in this page indicates how to do it.
does it not work with older versions of aseprite? i set it up but it doesn’t run the audio when im playing an animation, unless there’s supposed to be a way to do so that i’m unaware of…
It may not be possible to use this extension with significantly older versions of Aseprite. This is due to scripting differences (or the lack of scripts altogether) in these older versions.
Recent versions of Aseprite should work just fine though. What version are you using?
how would i get this to work with libresprite ? i seem to have done everything right but it wont work... ) :
Aseprite Audio Extension v2.1 does not work with Libresprite. The script that AAE uses to hook to Aseprite is built on Lua, and I haven’t yet looked into porting it to JavaScript (used by Libresprite). This may be a feature to be implemented in the future.
This doesn't seem to work if the duration of a frame isn't 100
Frame duration is an important element at play for this extension to work. If you mean that the audio is stuttering when the duration of all frames isn’t 100, thanks for reporting this! I’m currently working on fixing stuttering related issues.
Do make sure that all frames have the same duration though, as the extension only looks at the current frame’s duration to calculate when to seek the audio to.
I had some frames that were slower than the rest, making them all have the same duration fixed the issue, thanks.
It does still jitter though, especially with lower frame durations.
Yeah, I used lower frame durations for testing and the situation is REALLY bad. I’m currently working on another version that patches a bunch of things. Expect an announcement soon :)
help me
I will help you.
You got this.
hi idk if im the only one but it looks to be broken. i just downloaded it. and it showed a black screen
This might be a graphic card issue. Try checking your system information against the requirements listed here.
Hi I'm not sure why but I can't get this tool to work at all.
I just freshly bought aseprite because I was hoping to take the animations I've been doing on OpenToonz elsewhere, but I need audio for the work I do.
Here's the steps I took:
1. I installed Aseprite onto my PC through steam.
2. I downloaded this extension and extracted its contents into a new folder titled 'Extensions' I created in my Documents.
3. After extracting to that folder I created, I opened the AAE V2.0.exe and clicked setup.
4. I went to Browse Local Files on steam for Aseprite and copied the entire path that lead to its .exe.
Program Files (x86)\Steam\steamapps\common\Aseprite
5. I pasted it into the Aseprite Path box and clicked Activate.
And from there nothing happens. It doesn't open aseprite, it doesn't play audio alongside the animation. I click the box and NOTHING happens. I don't know what I'm doing wrong, please help!
I'm probably missing something obvious; I am completely new to this software.
I'm on Windows 10, AMD Ryzen 7 5800x core Processor and NVIDIA GeForce RTX 3060
Literally the same minute I made this post I found my problem 🤦♂️ in case anyone else is having this issue; make sure that the file path doesn't end at the folder the .exe is located in, but actually has the .exe in the path.
so it should end with 'Aseprite\Aseprite.exe'
i did that but i have the same issue
nvm i had quotations around my path
can we have smth like this for libresprite
Hi! For those having this particular error when trying to activate the Aseprite path using the 2.0 version of AAE, you must be missing the path and file which will cause this error.
To fix this:
There is something wrong with the automatic creation of the lua script on the specified file and so you just had to do it manually. Nothing is really broke.
***For reference (this is mostly for DDMPlayer lel), I am using Windows 11 (i'm sorry), with a AMD Ryzen 5 7640HS Processor and NVIDIA GeForce RTX 4050 Laptop GPU.
Hope this helped! This is a extremely sought after feature that Aseprite won't give us for years now, so I hope more people should be able to use it .
Hey there! Thanks for providing help for this issue! I’ll try to patch up the script copying sometime soon, but thanks a ton for providing your solution already :)