User Tools

Site Tools


rocrailonastick-en

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
rocrailonastick-en [2021/02/27 09:00] – [Raspberry Pi] rjversluisrocrailonastick-en [2024/03/13 13:17] (current) rjversluis
Line 1: Line 1:
-====== Rocrail ZIP ====== 
 [[:english|{{  :rocrail-logo-35.png}}]][[:rocrailonastick-de|{{ :icons:de.png}}]][[:rocrailonastick-en|{{ :icons:uk.png}}]] [[:rocrailonastick-fr|{{ :icons:fr.png}}]] [[:rocrailonastick-nl|{{ :icons:nl.png}}]] [[:english|{{  :rocrail-logo-35.png}}]][[:rocrailonastick-de|{{ :icons:de.png}}]][[:rocrailonastick-en|{{ :icons:uk.png}}]] [[:rocrailonastick-fr|{{ :icons:fr.png}}]] [[:rocrailonastick-nl|{{ :icons:nl.png}}]]
 +====== Rocrail ZIP ======
   * [[:download-int|Download]] | **[[:rocrailonastick-en|Rocrail ZIP]]** | [[win-changetozip-en|Change to ZIP Installer on Windows]]   * [[:download-int|Download]] | **[[:rocrailonastick-en|Rocrail ZIP]]** | [[win-changetozip-en|Change to ZIP Installer on Windows]]
  
Line 23: Line 23:
  \\  \\
 ===== Instruction Videos ===== ===== Instruction Videos =====
-  * https://www.youtube.com/embed/Up4niKGJBl8+  * [[https://www.youtube.com/embed/Up4niKGJBl8|Nederlands (Dutch)]]
  
  
Line 29: Line 29:
  \\  \\
 ===== Unzipping and Starting ===== ===== Unzipping and Starting =====
 +==== macOS ====
 +Select the right installer for your Mac:
 +|< >|
 +^ CPU ^ Installer ZIP ^ Remark ^
 +| Intel | Catalina, Sierra, ElCapitan, Leopard | The Catalina build runs also on newer macOS Intel versions. |
 +| Apple Silicon M1/M2/M3 | Sonoma | 
 +
 +  - Double click on the zip file to unpack it.
 +  - Move or copy the Rocrail.app to your personal Applications folder. ( /Users/<username>/Applications )
 +
 +After every download the following steps are necessary for security reasons:
 +  - Open the Rocrail.app context menu in the Finder and select "Open".
 +  - Click on "Open" after the popup comes with "Are you sure you want to open it?".
 +
 +|  {{:mac:macos-open-rocrail-1.jpg?240}}  |  {{:mac:macos-open-rocrail-2.jpg?240}}  |  {{:mac:macos-open-rocrail-3.jpg?240}}  |
 +| After download the first double click blocks. | Open in the finder the context menu and select "Open". | Confirm to open the application. |
 +Alternative use the security:\\
 +{{:mac:macos-security-openanyway.png?240}}\\
 + \\
 +
 +
 ==== Windows ==== ==== Windows ====
 | Help for switching from a classic installation to the installation with a ZIP file: **[[:win-changetozip-en|Switching to ZIP installer]]** explained step by step. | | Help for switching from a classic installation to the installation with a ZIP file: **[[:win-changetozip-en|Switching to ZIP installer]]** explained step by step. |
Line 38: Line 59:
 Detailed installation instructions can be found under ** [[: win-en | Install Rocrail under Windows]] ** Detailed installation instructions can be found under ** [[: win-en | Install Rocrail under Windows]] **
    
 + \\
  
 ==== Linux ==== ==== Linux ====
-For an initial Rocrail installation, the dependency **wxWidgets** need to be installed. These commands are included in **installwx.sh**. \\ 
 Just unzip it in the home directory (not copied to the system) and double click on the **desktoplink.sh** to create a Rocview Desktop shortcut with all needed parameters to startup a workspace.. \\ Just unzip it in the home directory (not copied to the system) and double click on the **desktoplink.sh** to create a Rocview Desktop shortcut with all needed parameters to startup a workspace.. \\
 +
 +=== Builds ===
 +Check this table which build is compatible with the target Linux distribution:
 +^ Build ^ Compatible with ^ Architecture ^
 +| Debian 11 | Debian 12, LMDE 5, Mint 20, Manjaro LTS, Ubuntu 20, Ubuntu 22, openSUSE 15 | i386, AMD64, x86_64 |
  
 === Terminal === === Terminal ===
Line 51: Line 77:
 ./desktoplink.sh ./desktoplink.sh
 </code> </code>
 +<html><!--
 If the wxWidgets library is not yet installed: If the wxWidgets library is not yet installed:
 <code> <code>
 ./installwx.sh ./installwx.sh
 </code> </code>
 +--></html>
 +
 +
  
 ===Gnome Desktop=== ===Gnome Desktop===
Line 66: Line 96:
 After Gnome Tweaks did open, select in the left column "Extensions", and activate "Desktop icons".\\ After Gnome Tweaks did open, select in the left column "Extensions", and activate "Desktop icons".\\
 The Rocview Desktop Icon will at first look like a text document. Activate in the context menu, right click on this icon, and activate "Allow Launching".\\ The Rocview Desktop Icon will at first look like a text document. Activate in the context menu, right click on this icon, and activate "Allow Launching".\\
 +
 +===Taskbar Panel===
 +To be able to pin Rocview on the Taskbar Panel the Rocview.desktop file must be copied to the applications directory:
 +<code>
 +sudo cp ~/Desktop/Rocview.desktop /usr/share/applications 
 +</code>
 +Search for Rocview in the Startmenu and start it. Now the Rocrail Icon can be pinned on the Panel.\\
 +{{:install:cinnemon-rocview-panel.jpg|Cinnamon}}\\
 +**Note:** On some systems the Desktop directory has another name like //Schreibtisch//. (Depending on the selected language.)\\
 +
 +
  
  \\  \\
Line 71: Line 112:
   * __**[[:raspi:install:rpi-install-en|Graphical installation for novice users.]]**__ (recommended)\\   * __**[[:raspi:install:rpi-install-en|Graphical installation for novice users.]]**__ (recommended)\\
   * __**[[:download-int#raspberry_pi|Terminal installation for experts.]]**__ \\   * __**[[:download-int#raspberry_pi|Terminal installation for experts.]]**__ \\
 +
 +=== Builds ===
 +Check this table which build is compatible with the target Linux distribution:
 +^ Build ^ Compatible with ^ Architecture ^ Manufacturer ^
 +| PiOS11 | Ubuntu 20, Ubuntu 22, Manjaro, Armbian 22 | ARMHF, ARM64 | Raspberry Pi, Odroid |
 +
 +
  
  \\  \\
 ===== Update ===== ===== Update =====
 +====macOS====
 +  - Download a current ZIP-Archive.
 +  - Double click on the zip file to unpack it.
 +  - Copy, overwrite, the Rocrail.app in your personal Applications folder. ( /Users/<username>/Applications )
 +  - For opening the application see [[#macos|Unzipping and starting macOS]]
 +
 +
 + \\
 +====Windows====
 **Important Note:** \\ **Important Note:** \\
 In order for an update not to overwrite files modified for own purposes (Images, SVG, Decspecs etc.), these must be saved with changed file names or in a separate directory. In order for an update not to overwrite files modified for own purposes (Images, SVG, Decspecs etc.), these must be saved with changed file names or in a separate directory.
Line 83: Line 140:
  
  \\  \\
-==== Advanced Update Option ====+=== Advanced Update Option ===
 |  Not for novice users!  | |  Not for novice users!  |
  
Line 94: Line 151:
  \\  \\
 ===== Demo and Wiki Plans ===== ===== Demo and Wiki Plans =====
 +|< >|
 +^  Demo-Plan  ^  Wiki-Demo-Plan \\ "Step by Step"  ^
 +|  {{:install:demo-plan.png?0x200}}  |  {{:install:wiki-demo-plan.png?0x200}}  |
 To access the Demo plan select File->Demo Workspace. \\ To access the Demo plan select File->Demo Workspace. \\
 To access the Wiki Demo plan select File->Open Workspace (in this directory look for the wikidemo folder and select.) \\ To access the Wiki Demo plan select File->Open Workspace (in this directory look for the wikidemo folder and select.) \\
Line 101: Line 161:
  \\  \\
 ===== Directory structure ===== ===== Directory structure =====
 +====Windows / Linux====
 <code> <code>
 Rocrail Rocrail
Line 109: Line 170:
 ├───revision-xxxxx.info (Revision number and the last 500+ revisions) ├───revision-xxxxx.info (Revision number and the last 500+ revisions)
 ├───desktoplink.sh      (Linux   -- Icon on the desktop) ├───desktoplink.sh      (Linux   -- Icon on the desktop)
-├───installwx.sh        (Linux   -- Install wxWidget) 
 ├───rocrail.png         (Linux   -- Rocrail icon) ├───rocrail.png         (Linux   -- Rocrail icon)
 ├───rocview.sh          (Linux   -- Rocview and Server) ├───rocview.sh          (Linux   -- Rocview and Server)
 ├───rocrail.sh          (Linux   -- Server only) ├───rocrail.sh          (Linux   -- Server only)
-├───web                 (Rocweb data)+├───startrocrail.sh     (Linux   -- Script for use with crontab; Copy or symlink it into ~) 
 +├───initdefault.sh      (Linux   -- Init default workspace with symlinks to: svg, web, images, decspec) 
 +├───update.sh           (Linux   -- Update Rocrail by Server Monitor) 
 +├───sysupdate.sh        (Linux   -- Update OS by Server Monitor) 
 +├───default             (Default empty workspace in case of crontab and/or Server Monitor)
 ├───wikidemo           ├───wikidemo          
 |   └───plan.xml        (wiki demo plan) |   └───plan.xml        (wiki demo plan)
 ├───demo                (default demo workspace) ├───demo                (default demo workspace)
 |   └───plan.xml        (larger plan with shadow station) |   └───plan.xml        (larger plan with shadow station)
-├───bin                 (Client/Server/Libraries - exe and dll)+├───web                 (Rocweb data) 
 +├───bin                 (Executables and libraries)
 ├───decspecs            (Rocpro decoder specification) ├───decspecs            (Rocpro decoder specification)
 ├───stylesheets         (Docu formats) ├───stylesheets         (Docu formats)
 ├───images              (Pictures: Symbols, Locs, Wagon, ...) ├───images              (Pictures: Symbols, Locs, Wagon, ...)
 └───svg                 (Scalable Vector Graphics) └───svg                 (Scalable Vector Graphics)
-    ├───userthemes.zip 
-    ├───americanthemes.zip 
     └───themes     └───themes
         ├───Accessories         ├───Accessories
 +        ├───CTC
         ├───Roads         ├───Roads
         ├───SLIM         ├───SLIM
Line 133: Line 197:
  
 </code> </code>
 +
   * **Note:** The individual **[[http://rocrail.net/software/rocrail-snapshot/|"Rocrail Zip" ZIP archives]]**  contain only the parts of the Directory structure above \\ that are relevant for the respective Operating system.   * **Note:** The individual **[[http://rocrail.net/software/rocrail-snapshot/|"Rocrail Zip" ZIP archives]]**  contain only the parts of the Directory structure above \\ that are relevant for the respective Operating system.
 + \\
 +====macOS====
 +<code>
 +Rocrail.app
 +└───Contents          
 +    ├───_CodeSignature            (Optional code signing with Apple Developer ID)
 +    ├───Frameworks                (Libraries *.dylib)
 +    ├───MacOS
 +    |   ├───Run
 +    |   ├───rocrail
 +    |   └───rocview
 +    ├───Resources
 +    |   ├───Rocrail.icns
 +    |   ├───data
 +    |    ├───decspecs            (Rocpro decoder specification)
 +    |    ├───stylesheets         (Docu formats)
 +    |    ├───images              (Pictures: Symbols, Locs, Wagon, ...)
 +    |    ├───web                 (Rocweb data)
 +    |    └───svg                 (Scalable Vector Graphics)
 +    |       └───themes
 +    |          ├───Accessories
 +    |          ├───CTC
 +    |          ├───Roads
 +    |          ├───SLIM
 +    |          ├───SLIM-COLOR
 +    |          └───SpDrS60
 +    |   └───demo
 +    |    └───plan.xml
 +    |   └───wikidemo
 +    |      └───plan.xml
 +    └───Info.plist
 +
 +</code>
 +
 +The Run command will create the following local directory structure:
 +<code>
 +~/rocrail
 +├───decspecs
 +├───images
 +├───stylesheets
 +├───svg
 +├───web
 +├───wikidemo      (Wiki plan)
 +└───plan.xml      (Demo plan)          
 +</code>
 +Newer files in the Rocrail.app will overwrite the existing files in the ~/rocrail directory except for ~/rocrail/plan.xml.\\
 +  * Store local user SVGs in its own directory.
 +  * Use a separate Workspace for your own plan.xml.
 +
 + \\
 +
 + \\
 +=====Trouble shooting Linux=====
 +====Wayland====
 +The Wayland WindowManager comes with following restrictions:
 +  * Rocview cannot restore its inner windows correctly if the vertical toolbar option is set.
 +  * Restoring window and dialog positions is not possible.
 +
 +===Solution===
 +Change the Exec line in the desktop file into:
 +<code>Exec=env GDK_BACKEND=x11 ....</code>
 + \\
 +====Serial Device Access====
 +Add the user to the group dialout: **[[;faq-en#serial_device_user_access_linux|FAQ]]** \\
 +
  
rocrailonastick-en.1614412844.txt.gz · Last modified: 2021/02/27 09:00 by rjversluis