https://github.com/zpg6/aseprite-preview

VSCode / Cursor extension for quick previews of Aseprite pixel art files (.aseprite and .ase). Only meant for a quick look at a sprite to save having to open it fully in Aseprite.
https://github.com/zpg6/aseprite-preview

Last synced: 8 months ago
JSON representation

VSCode / Cursor extension for quick previews of Aseprite pixel art files (.aseprite and .ase). Only meant for a quick look at a sprite to save having to open it fully in Aseprite.

• Host: GitHub
• URL: https://github.com/zpg6/aseprite-preview
• Owner: zpg6
• License: mit
• Created: 2025-09-27T14:00:43.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-09-27T15:59:04.000Z (8 months ago)
• Last Synced: 2025-09-27T16:08:35.873Z (8 months ago)
• Language: TypeScript
• Homepage:
• Size: 236 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Aseprite Preview

[![VS Code Extension Version](https://img.shields.io/visual-studio-marketplace/v/grimaldi-tech.aseprite-preview)](https://marketplace.visualstudio.com/items?itemName=grimaldi-tech.aseprite-preview)

[![VS Code Extension Downloads](https://img.shields.io/visual-studio-marketplace/d/grimaldi-tech.aseprite-preview)](https://marketplace.visualstudio.com/items?itemName=grimaldi-tech.aseprite-preview)

[![License: MIT](https://img.shields.io/github/license/zpg6/aseprite-preview)](https://opensource.org/licenses/MIT)

Visual Studio Code / Cursor extension for quick previews of [Aseprite](https://github.com/aseprite/aseprite) pixel art files (`.aseprite` and `.ase`). Only meant for a quick look at a sprite to save having to open it fully in Aseprite.

![Aseprite Preview](./docs/screenshot.png)

## Features

- 🎨 View `.aseprite` and `.ase` files directly in VS Code

- 🎬 Play animations with frame controls

- 🔍 Zoom from 1x to 16x

- 📊 Show sprite info (size, frames, layers)

- 🎯 Toggle between smooth and pixel-perfect rendering

- 🎭 Multiple background options

- 📸 Export current frame as PNG

## Installation

Install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=grimaldi-tech.aseprite-preview) or search for "Aseprite Preview" in the Extensions view.

## Usage

Just click on an `.aseprite` or `.ase` file in VS Code. Use the toolbar to play animations, zoom, and adjust settings.

## Development

```bash

npm install

npm run compile

# Press F5 to test

```

Built from scratch with zero external dependencies using the [official Aseprite file format specification](https://github.com/aseprite/aseprite/blob/main/docs/ase-file-specs.md).

## License

[MIT](./LICENSE)

## Contributing

Contributions are welcome! Whether it's bug fixes, feature additions, or documentation improvements, we appreciate your help in making this project better. For major changes or new features, please open an issue first to discuss what you would like to change.