aman601 / project-clippi

An automation framework for Super Smash Bros. Melee. Detect an event → execute an action.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Project Clippi Logo

Project Clippi

An Automation Framework for Super Smash Bros. Melee

Build Status License

Project Clippi is your must-have Slippi toolkit for tapping into real-time game data and processing replay files. Automatically execute actions when an in-game event occurs. Automatically find and curate combos for that sick combo video. Automatically rename and reorganise your SLP files.

Everything is open source and fully-customisable. The possibilities are endless.

Screenshots

Detect events and execute actions!

Project Clippi main screenshot

Built in replay processor helps you find combos and organise your SLP replays!

slp file processor screenshot

Easily load SLP files into Dolphin with just a drag and drop!

Project Clippi playback queue screenshot

Highlights

  • Detect in game events and execute arbitrary actions
  • Customisable profiles for easy combo curation and combo video generation
  • One-click sort and rename your SLP files with ease
  • Twitch and OBS integration

Download

Download Project Clippi for your operating system using the links below or check out the releases page for more information.

Usage

To make combo videos using the Project Clippi, check out this guide on using the Replay Processor.

To take advantage of real-time game events you will need to connect Project Clippi to a console source using the Slippi Desktop App as a relay. Check out this guide for connecting to a relay.

Contributing

If you found Project Clippi useful and would like to give back here's how you can:

  • Spread the word! The more people that use it, the more Project Clippi can improve!
  • If you have ideas for new features, or would like to report a bug, please tweet at @ProjectClippi.
  • If you are gifted in the way of code, you can help by adding more detectable events and more executable actions. Dive into the docs for the slp-realtime library which underpins this project and the source code for the Project Clippi front-end.
  • PRs are welcome and encouraged! Do make sure to read through the development guidelines though.

Development

Start the development server using:

yarn run start

The development server includes HMR and auto-reloading so changes to both the main and renderer processes should auto-update.

To create a binary package:

yarn run dist

For more detailed instructions on development and building the project from source, check out the Build Process section.

Acknowledgements

Project Clippi wouldn't be here without the work of Jas Laferriere, the rest of the Project Slippi team, and all the Project Clippi supporters.

License

This software is released under the terms of MIT license.

About

An automation framework for Super Smash Bros. Melee. Detect an event → execute an action.

License:MIT License


Languages

Language:TypeScript 98.9%Language:JavaScript 0.9%Language:CSS 0.2%