wakey-wakey
This repository contains the source code for the paper Wakey-Wakey: Animate Text by Mimicking Characters in a GIF
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
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
Metadata Files
README.md
Wakey-Wakey
This repository contains the source code for the paper Wakey-Wakey: Animate Text by Mimicking Characters in a GIF.

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

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
- Driving Animation Key Point Extraction: The project first extracts key points from the given GIF using a pre-trained First-Order Motion Model (FOMM).
- 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
- Repositories: 7
- Profile: https://github.com/KeriYuu
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