Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 

dweet player

Allows you to make multi-part demos out of dweets.

Running locally

Make a copy of .env.example as .env and edit accordingly. You need:

  • An API key from FMA

Then:

npm install

npm start

Then visit: http://localhost:7890

Usage

Demo encoding

Demos are encoded in the URL with the following structure:

/demo/v1/<loader dweet ID>/<timeline>/<audio track URL>

Where:

  • loader dweet ID is the dweet to use as a loader. If you don't want to specify one, use "*" to randomly pick one from a pool. Loader dweets should complete their progress animation when t reaches 1.
  • timeline An array of scenes. Each scene is a dweet ID + some effects. More on this below.
  • audio track URL - Full URL of an audio track. Currently, only tracks URLs from Free Music Archive are supported.

The timeline string is a comma-separated list of scenes: <scene 1>,<scene 2>,....

Each scene starts with a dweet ID, followed by a combination of these optional components:

  • A duration specifier
  • A time warping specifier
  • A trigonometric function (sine, cosine, tangent) morphing specifier
  • A "blender" (bad name for what it actually does)
  • A "=" at the very end to make the scene contiguous with a prior appearance of the same dweet i.e. dweet frame/t values continue increasing. By default, each dweet's runtime is reset every time they're shown.

Duration specifiers can be:

  • Exact time: @[<seconds>] - Runs the dweet for exactly the specified amount of seconds. When omitted, 5 seconds is the default.
  • Approximate time: ~[<seconds>] - Runs the dweet around the specified amount of seconds, waiting for the next beat. 5 seconds is the default.
  • Exact beats: ![<beats>]- Runs the dweet for exactly the specified number of beats. 5 beats is the default.

Time warping specifiers can be:

  • Beat rush: t[<amount>] - Rushes the time forward on beats. The amount determines how much to rush. 5 frames (5/60 seconds) is the default.
  • Beat bounce: T[<amount>] - Bounces the time foward and then back (restores normal time) on beats. The amount determines how much to bounce. 5 frames is the default.

Trig morphing specifiers can be:

  • Uniform: u[<amount>] - Morphs the trig functions by scaling their outputs on beats. The amount determines how much to scale. 5 is the default and it means by %50.
  • Random: r[<amount>] - Morphs the trig functions by scaling their outputs on beats, by a random factor. The amount determines how much to scale. 5 is the default and it means by a maximum of %50 (when the random factor is 1).
  • FFT: f[<amount>] - Morphs the trig functions by scaling their outputs by the values of the FFT bins as factors (0-1, spread over 2π). The amount determines how much to scale. 5 is the default and it means by %50.

Blenders can be:

  • Zoom: z[<amount>] - Zooms in on beats. The amount determines how much to zoom. 5 (5%) is the default.
  • Vertical mirror: v[<position>] - Makes a flipped copy of a part of the canvas as if there's a vertical mirror. The position determines where the mirror is. 5 (50% of the screen) is the default.
  • Horizontal mirror: h[<position>] - Makes a flipped copy of a part of the canvas as if there's a horizontal mirror. The position determines where the mirror is. 5 (50% of the screen) is the default.
  • White flash: w - Flashes to white (#ffffff) on beats.
  • Black flash: b - Flashes to black (#000000) on beats.

About

Musical dweet remixer

Resources

Releases

No releases published

Packages

No packages published