Windows Walkthrough (getting started summary)

Here’s a summary of what i did to get SA working on my Win10 desktop…

setup/installation steps ---------------------------------------------
create local folder “c:\GitRepos\Superalgos”
install Chrome (https://www.google.com/chrome/)
install node.js (https://nodejs.org/en/) - all defaults
install Git (https://git-scm.com/) - all defaults
create an account with GitHub (https://github.com/) and log in,
—create a github ‘token’ with all permissions for a day (https://github.com/settings/tokens)
—clone Superalgos (into your account) (https://github.com/Superalgos/Superalgos -and click fork…)
install GitHub Desktop (https://desktop.github.com/) - all defaults
—use Credential Manager (so GitHubDesktop can access GitHub.com)
—sync your cloned SA repository with local SA folder
right-click c:\GitRepos\Superalgos → Git Bash Here
—$ node setup —wait for “downloading scripts bla bla” to finish
—$ node setupPlugins your-github-username-here your-github-token-here —wait for more repos to sync/install
Done :sweat_smile:

To run ----------------------------------------------------------------
right-click c:\GitRepos\Superalgos → git bash here
—$ node platform
open chrome
http://localhost:34248/

To end safely without data corruption ----------------------------
in app (in chrome), click “market data tasks” and “stop all data…”
in terminal (cmd/bash/powershell/etc) press ctrl+c

Only took me a week to distil this summary !!
More information about every step can be found in the SA/readme doc, and of course online…

update: 30-3-22

setup/installation steps -----------------------------------------------------------------------------------------
create local folder “c:\GitRepos\Superalgos”
install Chrome (google.com/chrome/)
install node.js (nodejs.org/en/) - all defaults
install Git (git-scm.com/) - all defaults
create an account with GitHub (github.com/ 1) and log in,
-------- create a github ‘token’ with all permissions for a day (github.com/settings/tokens)
-------- fork Superalgos (github.com/Superalgos/Superalgos -and click fork…)
install GitHub Desktop (desktop.github.com/) - all defaults
-------- use Credential Manager (so GitHubDesktop can access GitHub.com)
-------- clone SA repository with local SA folder
---------------- “fork” copies original SA files into your account (they are independent)
---------------- “clone” copies your SA files to your local folder (and keeps them synched)
right-click c:\GitRepos\Superalgos → Git Bash Here
-------- $ node setup —wait for “downloading scripts bla bla” to finish
-------- $ node setupPlugins your-github-username your-github-token —wait untill finished
Done :sweat_smile:

Update software ------------------------------------------------------------------------------------------------
node.js ----------- just install newer release ontop (this also updates python3 and VScode Tools)
git ----------------- open cmd>git update-git-for-windows
gitdesktop, VScode, chrome -------- done through software (eg: help->about->update)
SA ----------------- goto your copy of SA on github (github.com/UserName/Superalgos,
-----------------------& in the middle of the screen click “fetch upstream”)
Rclick c:\GitRepos\Superalgos → git bash here
----------------------$ node setup

update - Xmas 2022

Install ---------------------------------------------------------------------------------
make folder on desktop “SA” to contain shortcuts…
install Google Chrome, make it default browser (yes, annoying but do it anyways)
install Telegram (do it first on your phone, then install Telegram desktop and sync with phone)
install Microsoft Visual Studio Code
install Node.js (latest version, plus all extra crap)
goto Github, create account and/or login
install GIT (all defaults, use VSCode for Editor)
install GitHub Desktop (https://desktop.github.com/)

login to Github.com, go to your account (top right) → settings → dev settings → personal access tokens → gen new → “Superalgos”, NoExpirs, repo, workflow → generate (and COPY code)

Setup ------------------------------------------------------------------------------
[ my note: i deleted ALL existing SA repos, for another fresh start, as something went FUBAR ]
[ to delete in Github - chose a repo - goto settings -scroll to bottom - delete ]
goto Github.com homepage, at top left search, type superalgos, jump to “superalgos/superalgos”
follow instructions - make a fork (with OUT “master”) → master to develop → copy complete URL
https://github.com/YOUR-username-here/Superalgos/tree/develop
create a folder on your PC
D:\MyTechProjects\GitRepos\ (no need to create the Superalgos folder!)
rightclick → Git Bash Here (the GitRepos folder) → $ git clone https://github.com/YOUR-username-here/Superalgos (remove the /tree/develop bit)
$ cd superalgos
$ node setup shortcuts
$ node setupPlugins YOUR-username-here YOUR-github-token-code-here
$ node updateGithubRepos

All Done -------------------------------------------------
move all desktop shortcuts into SA folder

updates --------------------------------------------------
goto my fork in Github - YOUR-username-here/Superalgos - (in middle) click Sync fork (check Branches dropdown, make sure all are Sync’ed)
open terminal: (rightclick D:\MyTechProjects\GitRepos and chose Git Bash here)
type: $ node updateGithubRepos
Done