Need help with anim?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

JonComo
139 Stars 50 Forks Other 529 Commits 0 Opened issues

Description

Quick JS program for creating animations

Services available

!
?

Need anything else?

Contributors list

# 480,938
172 commits

anim

WARNING! Internal tool! Turn back while you still can! On that note, anim has started to become actively managed! Feel free to submit issues and they just may be addressed :-)

Anim is used to make animations and graphs for the youtube series, https://www.youtube.com/watch?v=ZzWaow1Rvho

Quick user guide (subject to change or be out of date as the code changes):

This was made to assist in creating quick animations for my youtube series on neural networks. You can add text, circles, and draw shapes. An object's properties are smoothly transitioned while presenting.

Setup

(If you are planning to modify

anim
, see the development setup guide!)

anim
is available both as source code and as a bundled
index.html
,
main.*.js
and a few extra files (including licenses and source maps). If you are not planning to modify
anim
, you should proceed with the second option. This section describes how to do so.

To run

anim
, you can visit the GitHub Pages site which hosts the compiled code. However, the code is available for download at https://github.com/JonComo/anim/releases (instructions are available under Downloading). This enables you to open an
index.html
file in your favorite browser and use
anim
there, with the added benefit of
anim
working while you don't have a valid internet connection. Keep in mind that a local copy of
anim
might become outdated.

Downloading

  1. Visit https://github.com/JonComo/anim/releases and pick a release (if you have no preference, go with the latest). Releases

  2. Choose an archive format. Click on it to download. You'll need to be able to unarchive it once it's downloaded, so make sure your computer has the necessary software installed that correspond to the format you pick. Archive Download

  3. Navigate to where the archive was downloaded onto your system. If you are on Windows and have downloaded the

    .zip
    archive, right-click it and select Extract All, and then follow the on-screen instructions. On macOS, it should be sufficient to double-click the archive. Finally, if you're running Linux, you can execute
    tar -xzvf .tar.gz
    or
    unzip .zip
    to unarchive the download. If you prefer the GUI, you might have an archive manager installed that will unarchive the download for you.
  4. Navigate into the

     directory (it doesn't have a file extension!) and open 
    index.html
    in your favorite browser. If all went well, you should now have a local copy of (compiled)
    anim
    .
  5. Since the archive has been extracted, you can delete it. If you'd like to download another version of

    anim
    , follow the previous steps again. If you are not planning to use a local version of
    anim
    anymore, you can delete the extracted directory that contains it.

Frequently Used Features

(A more elaborate help section can be found by scrolling down on

anim
!)

Present: ctrl enter

Exit present mode: esc

Change frames: keys 0 and up or left and right arrow keys.

Insert frame: + button Remove current frame: - button

Add objects: Select the tool for the object you want to create Text: click to place a line of text under the mouse Shape or vector: click and keep clicking to draw a shape Press esc to finish Circle: click to place a circle under the mouse pointer

You can select objects with the select tool (which uses rectangular selection)

You can define functions in text objects by just typing them in.

f(x) = x^(2)

Then you can graph them:

graphxy(f)

(click the view xy button in the menu to rotate the 3D coordinate axes to see your 2D graph)

You can interact with a variable by using a slider (just type in into a text object):

slide:x

Then enter presentation mode, ctrl enter, and drag (with your mouse) the variable name left and right to change it's value.

Setup Guide (Development)

This section explains the process of setting up your own environment for developing

anim
.

Prerequisites

Before starting, you must have Node.js (https://nodejs.org/) and NPM (https://npmjs.com) installed on your system. Make sure you have Git (https://git-scm.com/) installed if you're planning to submit your modifications (or just want to keep track of your changes)!

Obtaining the code

First things first, you must download

anim
's code. Here are some options:
  • Clone this repository

If you're planning to play around with

anim
's code, but aren't really interested in contributing, go with this option. First, clone this repository using the command
git clone https://github.com/JonComo/anim
. Using this option will also let you update your local version of this repository whenever you feel like it. Just run
git pull
in the repository directory!
  • Use the GitHub CLI!

    If you have the GitHub CLI installed, then you can just clone this repository by executing

    gh repo clone JonComo/anim
    .
    • Fork this repository.

If you're going to submit code changes to this repository, then you should create a fork of it. To do so, navigate to this repository's URL (https://github.com/JonComo/anim) and press the Fork button in the top-right corner of the GitHub UI. Then, clone it using

git clone https://github.com//anim
or whatever software you please!
  • Fork with the GitHub CLI

    To fork this repo and then clone the fork with the GitHub CLI, run

    gh repo fork --clone JonComo/anim
    .
    • Download https://github.com/JonComo/anim/archive/master.zip and unzip it.
    • Use your software of choice!

I think you know what to do.

Install stuff

Once you have this repository's contents on your system, you must install some packages with NPM. These include ones like

webpack
and friends,
jquery
and more! To install them, run
npm install

Now, you should be all set to start modifying the code.

Starting it up

anim
uses the Webpack bundler: a program which squashes all of a project's code into a few files. You've already installed it in the previous step when running
npm install
. Now, all you need to do is run
npm start
to start the Webpack development server (Webpack dev server for short). Now, open your browser to https://localhost:9000/ and wait for a page to load. The Webpack dev server automatically bundles
anim
every time you change the code. Try editing the code and wait for the browser page to reload. Wow! Your changes are reflected in the browser. When you feel like you want to share your new and improved code with others, head on down to the next section.

Compile it!

Once you're satisfied with your changes, you can bundle everything up. Just run

npm run build
and look in the
dist/
directory. You should see a new file named
main.js
. This file is Webpack's compiled version of your code. Opening up
dist/index.html
in your browser should open up
anim
accompanied by your changes. Hooray!

That's about it for now! Good luck! Even now the code is begging for bug fixes and cleaning up... So much repetition of code too(not used to javascript.. okay, end of my excuses).

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.