The insallation of this program is not really difficult, but it is different -at least for Windows users. An this description seems to be endless. But don’t be afraid – This is only a ONE TIME effort. Just follow the instructions step by step and within short you should be finished. If you find something wrong – let me know so I can change the description.<\/p>\n
The installation is done on the commandline. This should be no problem for Linux users. As I don’t use MacOS I’m not sure whether all my advice is correct – however Google says it is OK. If not – please contact me – so I can correct.<\/p>\n
So let’s get started:<\/p>\n
You enter the commandline (Windows: Win-Key, type “cmd”, “as Administrator \/ Linux and MacOS: start terminal from Gui or you are on commandline anyway. Linux: depending on which user you are logged on you may have to add “sudo” to each command.<\/p>\n
The steps are<\/p>\n
On many systems Node.Js is pre-installed. On any system you can test whether it is installed or not using the commands:<\/p>\n
<\/p>\n
npm -v and node -v<\/p>\n
If the answer is a version number it is already installed and you can skip this step.<\/p>\n
Windows:<\/strong> Should you still have a Windows 10 system with 32 bit architecture this program will not work. Nodejs stopped developement for x86 systems some time ago.<\/p>\n \u00a0macOS (mit Homebrew)\u00a0<\/strong><\/p>\n <\/p>\n<\/div>\n <\/p>\n After this node.js should be installed. You may test again with<\/p>\n Node -v\u00a0 and npm -v\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 to fine out everything went fine.<\/p>\n This can be done on all systems the same way:<\/p>\n First you create an empty folder (via commandline) and change into that folder: Then you enter (exactly as shown here – use copy\/paste) Afterwards you unpack the archive Linux\/MacOS: As a result you should see a number of files in your folder now. You may delete the “Datei.zip”.<\/p>\n Now you have to edit the .env file in that folder<\/p>\n Windows: Edit .env This is the content of that file:<\/p>\n # Server Configuration # SMTP Configuration # File Paths The SMTP parameters are used for sending emails to yourself (e.g. from the caller diary). You may have to look up the correct setting with your email provider.<\/p>\n The MUSIK_PATH is important. This tells the program where your music resides. With Linux this is a paht like “\/home\/xxx\/music” In Windows this is any path in Windows format. Beneath this folder you should have several sub-folders eg “Singing”, “Patter”, “Sting”, “Rhythm”. Naming and organization is your choice. One exception: Patter is handled different from the other folders. So any Patter folder MUST HAVE the word “Patter” in it (eg. “MyPatter”, “HisPatter” …).<\/p>\n You can also place the “Daten” folder and the database on any drive\/folder. If you keep it as shown above it will be in the program folder (where is just has been unpacked). I recommend not to change it. You may also make changes later or when your email-parameters change.<\/p>\n Don’t forget to save the .env file after making changes.<\/p>\n Now some modules need to be loaded from the internet. The command is:<\/p>\n npm install<\/p>\n It may take a while – depending on your internet speed. Be patient. Ignore any warnings for now<\/p>\n This step creates a folder in the program folder named “node_modules”. Please ignore it – but don’t delete – it is required.<\/p>\n Now you may start the program for the first time (same command on all systems)<\/p>\n npm run dev<\/p>\n There will be some messages on the commandline. You now may start any browser and point it to:<\/p>\n http:\/\/localhost:2900\u00a0<\/a> (or whichever port you selected). Then you see the first screen of the program.<\/p>\n You may also start via the IP-address of your PC\/laptop<\/p>\n http:\/\/192.168.178.xxx:2900\u00a0 \u00a0(example your IP will be different)<\/a><\/p>\n You may also use your mobile device (phone or tablet) with the second command. If\u00a0 the Android or IOS device is in the same network it will run the program.<\/p>\n One disadvantage: the commandline will be blocked. As soon as you close the commandline window – the program will stop.<\/p>\n To overcome this disadvantage some more commands are necessary:<\/p>\n npm install -g pm2<\/p>\n pm2 start ecosystem.config.cjs<\/p>\n After running the 2 commands you can close the terminal. The disadvantage of this method is that the program will run in background until the PC\/laptop is powered off and will continue to use ressources. You can stop the memory usage by entering<\/p>\n pm2 stop 0<\/p>\n and restart it with<\/p>\n pm2 start 0<\/p>\n For each system there is a command-file beginning with “start_”.<\/p>\n You may try to use the respective command AFTER you edited the env. file. With some luck the following steps will be donw automatically and the program will start immediately (at least in Windows). If it works you may start the program with this command each time you use the program.<\/p>\n When testing on several differnt system – specially on Windows system – I had all kind of errors. Should you experience the same use the manual way as described above.<\/p>\n But it is worth trying. You can’t destroy the system!<\/p>\n On LInux do not forget to make the “start_linux.sh” executable <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" The insallation of this program is not really difficult, but it is different -at least for Windows users. An this description seems to be endless. But don’t be afraid – This is only a ONE TIME effort. Just follow the …<\/span> Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-102","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ctbonline.nanninga.me\/en\/wp-json\/wp\/v2\/pages\/102","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ctbonline.nanninga.me\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ctbonline.nanninga.me\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ctbonline.nanninga.me\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ctbonline.nanninga.me\/en\/wp-json\/wp\/v2\/comments?post=102"}],"version-history":[{"count":27,"href":"https:\/\/ctbonline.nanninga.me\/en\/wp-json\/wp\/v2\/pages\/102\/revisions"}],"predecessor-version":[{"id":146,"href":"https:\/\/ctbonline.nanninga.me\/en\/wp-json\/wp\/v2\/pages\/102\/revisions\/146"}],"wp:attachment":[{"href":"https:\/\/ctbonline.nanninga.me\/en\/wp-json\/wp\/v2\/media?parent=102"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\nwinget install OpenJS.NodeJS.LTS –silent
\n<\/strong><\/p>\nnode@20<\/code> or similar)<\/div>\nbrew install node@20\r\n<\/span><\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
brew link --overwrite node@20<\/code>).<\/span>\u00a0<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
\ncurl -fsSL <\/span>https:\/\/deb.nodesource.com\/setup_lts.x<\/span> | sudo -E bash - && sudo apt-get install -y nodejs<\/span><\/code><\/div>\nUnpack my program into an empty Folder<\/h3>\n
\nWindows: x: (Drive); md “xxx”; cd “xxx”.
\nLinux: mkdir \/opt\/xxx (suggested); cd \/opt\/xxx<\/p>\n
\nWindows:
\ncurl -L -o datei.zip https:\/\/fg.nanninga.me\/$\/xIJd1<\/p>\n
\ntar -xf datei.zip (Windows)<\/p>\n
\nwget -O datei.zip https:\/\/fg.nanninga.me\/$\/xIJd1
\nDann: \u00a0unzip datei.zip<\/p>\nEdit the file .env<\/h3>\n
\nIn Linux or MacOS use the editor of your choice (nano, vim ..).<\/p>\n
\n# Here you can configure the port to use. If 2900 is free on your system don’t change anything
\nAPP_PORT=2900<\/p>\n
\nSMTP_HOST=smtp.xxx.com
\nSMTP_PORT=465
\nSMTP_USER=meist Eure Email-Adress
\nSMTP_PASS=Euer Passwort
\nSMTP_FROM=Meist Eure Email-Adresse
\nSMTP_TO=An wen soll die Email gehen<\/p>\n
\n# Use absolute paths or relative to workspace root
\nMUSIK_PATH=h:\\SDMASTER
\nDATEN_PATH=Daten
\nDATABASE_PATH=SDMOmaster.db<\/p>\nLoad necessary modules<\/h3>\n
Start program<\/h3>\n
Run program in background<\/h3>\n
The alternative you may try<\/h3>\n
\nchmod +x start_linux.sh\u00a0 \u00a0and then
\nStart with “.\/start_linux.sh”<\/p>\n