Building and Running Locally to Export

This is intended for Mac users since there is a bug in the built application .dmg which prevents it from exporting recordings. However, when run in development mode, it does work. This attempts to get you up and running.

Warning

If these instructions don't go perfectly, this may not be easy

Doing this makes updating the app more difficult

Once done, this will use bit over 2GB of space

You CAN run this and the normal app at the same time

Most of these steps are not specific to this project, so if errors occur, look that way for common solutions unless noted.

Tools

Everything we do is going to be in the Terminal. If you have a tool, skip over that. If you have a better way to install, do that :)

Git

See if it exists...


        $ git --version 

        git version 2.20.1

If it says git: command not found or similar go install it.

Homebrew (needed for yarn)

See if it exists...


        $ brew --version 

        < some version info >

If it says brew: command not found or similar, you'll need to go install it. Be patient, this one takes many minutes.

Yarn

See if it exists...


        $ yarn --version 

        1.22.4

If it says yarn: command not found or similar, you need to install it. Run:


        $ brew install yarn

That should be it. Now we'll work with the actual code.

Code Setup

From here on, ~/Downloads is used as a base directory. It can be anything. You just want the resulting ~/Downloads/tablo-tools-electron directory somewhere you won't accidentally delete it.

First, we'll clone the code repository $ cd ~/Downloads $ git clone https://github.com/jessedp/tablo-tools-electron.git
That put a slew of files in ~/Downloads/tablo-tools-electron.
Now, we'll go there to install a lot of packages $ cd tablo-tools-electron $ yarn install That's prints a ton of information to the screen and takes a while. If it fails the first time, run it again just in case (I know).

Running the App

You made it! Everything should now be installed and ready to go.

Try to run the app:


      $ yarn dev

That should open the app very much like you are used to.

What's next?

Close the Developer Tools that open up in the way - you don't need them
Maybe create a shortcut to the yarn dev command
Updating to new Releases: $ cd ~/Downloads/tablo-tools-electron $ git pull --rebase $ yarn install
Don't change files in this ~/Downloads/tablo-tools-electron directory. Or do so at your own peril.