Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
March 6, 2023 17:08
November 11, 2019 14:38
March 6, 2023 17:08
August 7, 2019 14:13
March 10, 2023 17:06
March 10, 2023 17:06
February 9, 2021 19:14
November 6, 2021 20:12
November 9, 2016 23:45
November 6, 2021 20:12
November 12, 2018 13:34
March 6, 2023 17:08
November 13, 2017 01:23
March 10, 2023 17:06
September 1, 2022 15:36
September 6, 2021 16:48
November 10, 2021 18:27


Copyright (c) 2018 Dan Salvato LLC

Licensed under the Apache License, Version 2.0. See LICENSE.


FrankerFaceZ uses node.js to manage development dependencies and to run an HTTP server for development. This project uses the pnpm package manager. To get everything you need:

  1. Install node.js and pnpm
  2. Run pnpm install within the FrankerFaceZ directory.

From there, you can use npm to build FrankerFaceZ from source simply by running pnpm build. For development, you can instruct webpack to watch the source files for changes and re-build automatically with pnpm start

FrankerFaceZ comes with a local development server that listens on port 8000 and it serves up local development copies of files, falling back to the CDN when a local copy of a file isn't present.

Note: The local development server uses webpack-dev-server internally, which self-signs a certificate for hosting content via HTTPS. You will need to ensure your browser accepts a self-signed certificate for localhost.

To make FrankerFaceZ load from your local development server, you must set the local storage variable ffzDebugMode to true. Just run the following in your console on Twitch: localStorage.ffzDebugMode = true;

It should be noted that this project is not a browser extension that you would load in your browser's extensions system. You still need the FrankerFaceZ extension or user-script for your browser.

You can edit the project's icon font using the pnpm font command. This will create a new Fontello session, if one doesn't already exist, and open your default web browser to Fontello so you can edit the font.

If you're running the development server with pnpm start, you'll be able to automatically save changes to the Fontello font by clicking Fontello's Export button. Otherwise, you can use pnpm font:save to download the changes from your session.

Editor Settings

Please make sure that your editor is configured to use tabs rather than spaces for indentation and that lines are ended with \n. It's recommended that you configure linting support for your editor as well.

If you're using Visual Studio Code, make sure to install the ESLint extension and add the following to your workspace settings:

	"eslint.validate": [


The Twitch Enhancement Suite. Get custom emotes and tons of new features you'll never want to go without.







No packages published