A downloadable tool for Windows, macOS, Linux, and Android

Buy Now$5.00 USD or more

Community Showcase Vol. 2 Has Been Released!

Creating scrolling backgrounds made much easier and WAY FASTER!

Requires Aseprite Version 1.2.22 or newer.

On June 24th 2020 a user by the name of "Red-Halo" on the Aseprite Discord was in search for a way to animate scrolling backgrounds in a much faster way. I saw this comment and thought this feature could be very beneficial to the community. So naturally I rolled up my sleeves and got to work.

This toolbar started out quite small but has evolved exponentially. Due to this reason I decided that this needed to be its own separate toolbar apart from my main "Carbs Toolbar".

I'd love to see what your using this tool bar to work on! Use #CarbsTools on Twitter to share!


Minimize To Reduce Its Presence When Not In Use

Built-In Info / Help Section For Quick Reference

Supports 8 Directions Of Scrolling

Supports Multiple Layer Speeds / Parallax

Each layer can be set to a separate speed. Useful for layers that are farther away!

Supports Multiple Layer Directions

Each layer can be set to animate in a separate direction!

Animations Are Inserted At Cel Selection

This allows animations to have other frames that are not animated. Also allows you to produce a pause like effect.

NEW! Toolbar Auto Resize (Now Working)

Toolbar should now properly resizes its self even when using the file menu to launch the toolbar. (Previously the resizing only happened if you had the toolbar set up on a hotkey!)

The toolbar resizing should also now work properly with the following themes:

  • Default
  • Dase
  • Minimal Dark HD
  • Dark Mort HD

Let me know you use another theme I would love to test and support it!

Community Showcases

Check out these awesome examples of scrolling backgrounds! 



Check the video descriptions for all the links! :D

If you would like to share your own scrolling BG art be sure to tag @CarbsCode , use #CarbsTools on Twitter or leave a comment below with  a link to your art so he check what you have created!

I can't wait to see your scrolling backgrounds! 

To install / Run:

  1. File > Scripts > Open Script Folder
  2. Place BG Auto-Scroll Toolbar.lua in this folder
  3. Restart Aseprite
  4. File > Scripts>BG Auto-Scroll Toolbar to open

Currently the toolbar scrolls the entire canvas in the selected cel. Hope to add a selection option in a future update where it will only scroll a set selection of the cel :)

Hopefully the links in the thank you section are working in the mac and linux version. I am unable to test these versions so let me know if they are broken for some reason or if they are working correctly! Thanks guys!

--Simple Usage License / Rights-- 
By using the script included with this file you understand that you are using it ASIS with no guarantees. 
Though the script / toolbar is not intended to cause any harm, you understand that any such harm, such as lost of work, time or any other issues financial or otherwise, CarbsCode can not be held responsible.  Always save your work regularly! 
Please use at your own risk! If you change any of the script that may cause issues support may or may not be available. CarbsCode reserves the right to revise this license as needed. 
Use this script as a toolbar to assist in Aseprite for personal and professional use.
Learn from the code within.
Make changes as you see fit for your use-case. However support may not be available for modified scripts so do so at your own risk.
Re-sell, transfer or distribute entire script or parts of this script that are unique and / or not featured on the Aseprite API website. 
CarbsCode does not support NFTs and though he frowns upon the use of his tools for such works he understands that he can't stop users from doing so.
Though he asks kindly to please don't :)

Please report any bugs if you find some and Carbs will try and resolve as soon as possible!

Hope you all enjoy the tool! Please feel free to reach out or leave a comment if you have any issues or feedback!

โค Thank you all for the amazing support โค

Updated 21 days ago
PlatformsWindows, macOS, Linux, Android
Rated 5.0 out of 5 stars
(20 total ratings)
Made withAseprite
Tags2D, aseprite, parallax, pixel, Pixel Art, scrolling, tool


Buy Now$5.00 USD or more

In order to download this tool you must purchase it at or above the minimum price of $5 USD. You will get access to the following files:

BG Auto-Scroll Toolbar v1.1.4 17 kB
BG Auto-Scroll Toolbar v1.1.4 17 kB
BG Auto-Scroll Toolbar v 1.1.4 17 kB

Development log


Log in with itch.io to leave a comment.

Is there a way to animate a layer that has animation?

(2 edits)

Up, down, left, and right work fine but Diagonal isn't working right. It duplicates in different areas which seems weird to me 

Uh oh! Any chance you might be able to send a gif or video so I can see what's going on?

(1 edit)

There seems to be a bug where animations going left or right don't match at the end of the loop. All other directions are working as intended. But the loop is wrong for left and right directions. 

Love the script tho!

Oh gees that's not good xD I wonder if I broke left and right when I fixed up down and diagonals D:

I will take a look at this today when I get home from work :)

Any chance you could send me an example?

The only thing I can think of, if I didn't break something recently, would be that the ratio between the canvas size and the # of frames might result in a funky math leaving an extra pixel shift or something at the end. Also might deleting the last frame fix this for you? Any extra information on size and what's inputted in to the toolbar will help debug ๐Ÿ˜€ and fix up more quickly!

As a triple check if you could let me know what version of the toolbar and aseprite you are using aswell that would help a ton too ๐Ÿ˜€

I'm super glad your finding it useful btw! It's honestly my favorite of the tools that I've made so far because you get instant smooth results and if you don't like it you can undo in one quick step and try again ๐Ÿ˜€

Thank you for reaching out too! With out it its much harder to find issues ๐Ÿ˜†

(1 edit)

Oh gees yup I see what is happening. I must have broke this in my last update. I will get this fixed up today!

I've figured out what the issue was.  It was so small but a real bugger to find lol ๐Ÿ˜†

In lua the "or" operator works a bit differently then I had though. With some of my math related to horizontal shifting and vertical shifting I had used it like so:

If direction = "Left" or "Right" then 

<Math stuffs here>

But it should have been:

If direction = "Left" or direction ="Right"  then

<Math stuffs here>

See how little a difference this is but because both Left Right and up down do shifting it was shifting extra causing the issue ๐Ÿ˜†


I will put this update out today and this will be working in all directions again ๐Ÿ˜€

Update 1.1.4 this will be fixed so be sure to grab it when its up ๐Ÿ˜€

This update is now out :)

Duude! Awesome! Really glad that you found the bug! 

Thanks! :D

Yee! Your welcome! Thank you for bringing it to my attention! ๐Ÿ˜€

Now you can make the nice smooth animations again ๐Ÿ˜†

(1 edit)

Awesome script! The only issue I see is that there is a tiny stutter when an animation fully loops. You have to really be watching closely to see this problem. Is there a duplicated last frame or something? Can this issue be fixed in an update? Then this script would really be perfect!

Sorry for the delay!

I think that I might have found this issue, was it happening only on up down or diagonals? Left and right was okay or was it also happening on left and right?

I just uploaded an update which fixed some stuttering issues hopefully this was the issue you had!

Let me know if it's still doing it after you update :D


This tool is a life saver. The days of creating parallax animations manually is gone.


Yeah! I'm glad you're finding it quite useful!

Would love to see what you create with it :)

(1 edit)

One more great script from you. Thank you very much. I tried this script in Asperite for Linux (on Debian GNU/Linux) and everything works fine. Links in the "Thank You" section are working too. They correctly open in the default browser after clicking a button "Allow Execute Access".

Awesome! Glad to hear everything is working as planned  :) I do wish I could test these things out but its good that you were able to try it out and make sure :D So thank you for confirming this! Its quite helpful especially for future development as I know it will be working :)

And you are quite welcome! Its pretty great that I'm able to make something quite useful for the community :)

(2 edits)

I tested the script on Debian. The most common and popular Linux distributive is Ubuntu. Ubuntu is based on Debian. So in most cases this should work without problems. Some distributives may have some specific dependencies but this is a rare case. Thanks again for the script. Parallax animations created by your script look amazing and fantastically easy to make. It can save hundreds of hours.

Heck yeah! Thanks again for testing that :) would def love to see your scrolling backgrounds!! Its really fun to play with haha

how do you use the bg scrolling effect inside of unity or game engines?

You could export the animation either as a gif or as a spritesheet if your wanting to use just this animation you've set up.

 However in a game engine you might be better off just importing each layer and writing some code to handle this.

Its a bit complicated but I know in Godot there is an option in the texture to have it repeat which could be used some how.  I'm sure unity also has an option as well  but I've not used unity yet.

Also, another idea  I've seen before is a technique where you take the image and tween it to the left lets say and then spawn a copy all the way to the right off screen and keep that going which also moves to the left. Essentially while the one is moving off screen another is moving in to its place creating a loop effect.

I know there are probably atleast a couple handfuls of ways to do this though! :)

ok. and say no to godot. used it for 6 months not going back. I am used to using lot of other softwares besides godot. It don't support those export or don't have a plugin for it. And no m not wasting my time to make plugin for it. On the other hand unity has all plugins and works out of box. No crashes either. I got tired of godot T_T. So say no to godot aka GOAT! :P


Interesting I've actually had nothing but good experiences with Godot over the past couple years. Though I guess having experience in an engine is what you got to do to understand it more :) This is also why I don't poo poo unity because I haven't used it enough. I think they are both very great engines with tons of functionality. I agree sure Godot may be missing some stuff but thats the power of open source some one could make it happen :)

Out of curiosity what were you trying to import?  They have been adding alot of support lately :)

Either way I think once you find an engine its quite hard to swap to another. Atleast not as easily. Bit of a transition haha 

This is why I'm glad we have choices we can all use what we want and in the end its all about what we make with them :)

(1 edit)

Try making any 3rd party plugin for godot. An example would be making spriter animations work in godot or spine among many others.I have used 12 game engines so far. Keep coming back to unity. Unity is also annoying. Also 20x more resources for unity than any other engines combined. I am a fan of making my games finished or product released. So whatever tools makes it easier and have more solutions i tend to use it. Godot is awesome by itself and if u don't plan to use not many 3rd party software. Its mainly geared towards intermediate or expert programmer or hobbyists.


To each their own I guess :) Again this is why its nice that we have options :) People have different needs and preferences.  No harm in that :)

Personally I would rather figure things out my self then use a bunch of plugins especially when making games only because it gives you the freedom to do literally anything and your not restricted by what the plugin has to offer :)

Sure you could toss together a game that is 90% some one else's plugin but whats the fun in that and its super hard to debug or expand on because the plugins doesn't do that one thing you needed haha

But again that's just me I totally get that plugin make it easier to get the idea rolling but feel like using too many and relying on them could stunt your abilities especially when the plug in maybe stops working or something D:

I've actually heard great things of unity but often oven also seen people struggle with it too. Same can be said for godot. Sometimes the node system isn't for everyone. Again personally I find it quite intuitive :)

Works perfectly! Super pumped to see what will come from this. Thank you for the clear, concise directions in the info section. Sent a tip for it. Thank you again!

Thank you very much Xuriah! You are quite welcome, I tried my best to try and polish everything as much as I could :D I'm also hoping to make a little video on it showing off some cool techniques too!

Here is the little scene I might use for the video :3
Mountain Scene Night via CarbsCode Twitter

Annnnddd here is the video XD Working fast here! :D

Thanks for sharing this wonderful addition aseprite!


Absolutely! Hope you have a great time with it! :D Let me know if you have any troubles. Also would love to see what you create with it! :D Very fun tool to play with hahaha