wakey-wakey

This repository contains the source code for the paper Wakey-Wakey: Animate Text by Mimicking Characters in a GIF

https://github.com/keriyuu/wakey-wakey

Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 1 DOI reference(s) in README
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.4%) to scientific vocabulary
Last synced: 9 months ago · JSON representation ·

Repository

This repository contains the source code for the paper Wakey-Wakey: Animate Text by Mimicking Characters in a GIF

Basic Info
  • Host: GitHub
  • Owner: KeriYuu
  • License: mit
  • Language: CSS
  • Default Branch: main
  • Size: 4.69 MB
Statistics
  • Stars: 13
  • Watchers: 2
  • Forks: 1
  • Open Issues: 0
  • Releases: 0
Created almost 3 years ago · Last pushed almost 2 years ago
Metadata Files
Readme License Citation

README.md

Wakey-Wakey

This repository contains the source code for the paper Wakey-Wakey: Animate Text by Mimicking Characters in a GIF.

Interface

How to Run

Preliminary

Clone the repository and navigate into the project directory. Then follow the steps to set up the backend and frontend.

```bash

Clone the repository

git clone https://github.com/KeriYuu/Wakey-Wakey.git cd Wakey-Wakey/src

Set up the backend

cd backend conda create -n wakey python==3.10 conda activate wakey pip install -r requirements.txt

Set up the frontend

cd ../frontend npm install ```

Download the pre-trained FOMM model. You may use the following command or manually download the file.

bash cd ../backend/models wget https://disk.yandex.com/d/lEw8uRm140L_eQ/mgif-cpk.pth.tar

Running the Server

To run the project, you need to start the backend and front-end servers.

```bash

Start the backend server

cd backend python run.py bash

Start the frontend server in a new terminal

cd ../frontend npm run serve ```

Now, navigate to http://localhost:8080 in your web browser to use the application.

Authoring System

Interface

The interactive user interface of Wakey-Wakey consists of three main views:

  • Input View: Input text and customize its static appearance. You may also upload and preview the driving GIF. Click on the right arrow for the next step.
  • Correction View: Adjust the key points of the animated text at specific frames. Click on the right arrow for the next step.
  • Refinement View: You may refine the animation by adjusting the glyph's control points and configuring the algorithm’s parameters.

Key Components

  1. Driving Animation Key Point Extraction: The project first extracts key points from the given GIF using a pre-trained First-Order Motion Model (FOMM).
  2. Key Point and Text Control Point Alignment: The extracted key points are then aligned with the control points of the text to generate the animated text.

The final output is a GIF that animates the input text according to the movements in the input GIF.

Performance

An automatic generation takes around 300ms/frame (CPU: Intel i7 4.9 GHz). You can check the logs on the backend to monitor the generation progress.

Additional Notes

bibtex @inproceedings{xie2023wakey, title = {Wakey-Wakey: Animate Text by Mimicking Characters in a GIF}, author = {Xie, Liwenhan and Zhou, Zhaoyu and Yu, Kerun and Wang, Yun and Qu, Huamin and Chen, Siming}, booktitle = {Proceedings of the 36th Annual ACM Symposium on User Interface Software and Technology}, doi = {10.1145/3586183.3606813}, year = {2023}, articleno = {98}, numpages = {14}, publisher = {ACM}, address = {New York, NY, USA} }

Owner

  • Name: Keri Yu
  • Login: KeriYuu
  • Kind: user
  • Location: New York

Columbia 24' in Data Science | Fudan 23' BS in Physics

Citation (CITATION.CFF)

cff-version: 1.2.0
message: "Please kindly cite our paper if you would like to utilize some parts of our work."
abstract: Wakey-Wakey is an authoring tool for kinetic typography featuring GIF-guided generation.
authors:
  - family-names: Xie
    given-names: Liwenhan
    orcid: https://orcid.org/0000-0002-2601-6313
  - family-names: Zhou
    given-names: Zhaoyu
    orcid: https://orcid.org/0000-0002-8589-8088
  - family-names: Yu
    given-names: Kerun
    orcid: https://orcid.org/0009-0000-2647-4931
  - family-names: Wang
    given-names: Yun
    orcid: https://orcid.org/0000-0003-0468-4043
  - family-names: Qu
    given-names: Huamin
    orcid: https://orcid.org/0000-0002-3344-9694
  - family-names: Chen
    given-names: Siming
    orcid: https://orcid.org/0000-0002-2690-3588
title: Wakey-Wakey
version: 1.0.0
date-released: "2023-07-20"
doi: 10.1145/3586183.3606813
url: https://github.com/KeriYuu/Wakey-Wakey
keywords:
  - kinetic typography
  - animation
  - motion transfer
  - authoring tools
license: "MIT License"
preferred-citation:
  type: article
  authors:
    - family-names: Xie
      given-names: Liwenhan
    - family-names: Zhou
      given-names: Zhaoyu
    - family-names: Yu
      given-names: Kerun
    - family-names: Wang
    - given-names: Yun
    - family-names: Qu
    - given-names: Huamin     
    - family-names: Chen
    - given-names: Siming
  doi: 10.1145/3586183.3606813
  conference:
      name: "The 36th ACM Annual ACM Symposium on User Interface Software and Technology (UIST '23)"
  title: "Wakey-Wakey: Animate Text by Mimicking Characters in a GIF"
  type: proceedings
  year: 2023
  

GitHub Events

Total
  • Watch event: 3
Last Year
  • Watch event: 3