Toby Chui 2a1af92596 Add native macOS bridge to 3D Modeler il y a 2 jours
..
mod f3a6700c73 S3 drive: fix copying new files over SMB, cache metadata to cut round trips (#315) il y a 1 semaine
system 40f8de034b Revamp FTP and SFTP server management il y a 1 semaine
vendor-res baa3992364 V2.026 (#254) il y a 5 mois
wasm 5f84882b28 Refactor office system il y a 1 mois
web 2a1af92596 Add native macOS bridge to 3D Modeler il y a 2 jours
Makefile cef35f702a Add system font library and move locale files il y a 4 semaines
README.md f6e8875a97 V2.020 (#161) il y a 2 ans
agi-doc.md baa3992364 V2.026 (#254) il y a 5 mois
agi.go b7d65cafda Add setup wizard and module controls il y a 1 semaine
agi_runtime.go baa3992364 V2.026 (#254) il y a 5 mois
aimodel_settings.go baa3992364 V2.026 (#254) il y a 5 mois
appproxy.go 8013d31f15 Reorganize start menu categories and groups il y a 1 mois
apt.go b3cbca2f38 v2.0 Release (#129) il y a 3 ans
auth.go a9d3ac3c0f V2.025 (#202) il y a 11 mois
caldav_init.go 463c4429e3 Add CalDAV server for iOS Calendar bidirectional sync (#256) il y a 5 mois
cast.go adc5937ae6 TURN update for Arozcast screen share over Internet (#259) il y a 5 mois
cluster.fsinfo.go d241b540a2 Clarify cluster volume and virtual path IDs il y a 1 mois
cluster.fsinfo_test.go d241b540a2 Clarify cluster volume and virtual path IDs il y a 1 mois
cluster.go 573be4fa61 Restructure Storage Pool architecture il y a 1 semaine
cluster.jobs.go 573be4fa61 Restructure Storage Pool architecture il y a 1 semaine
cluster.thumbnail.go 5e0f3b0a5f Add cluster thumbnail rendering support il y a 1 mois
cluster.thumbnail_test.go 5e0f3b0a5f Add cluster thumbnail rendering support il y a 1 mois
cnn_settings.go d2cfed67c2 Add CNN inference API support il y a 4 mois
console.go b3cbca2f38 v2.0 Release (#129) il y a 3 ans
desktop.go 116d9f499e Add Assistive Access setting for readable titles il y a 1 semaine
devices.go 6b53644c31 Remove IoT Hub; localize settings pages il y a 3 semaines
disk.go baa3992364 V2.026 (#254) il y a 5 mois
docker.go 6e2cde632c Docker support (#264) il y a 4 mois
error.go bff80f3ce1 V2.108 Update (#145) il y a 2 ans
file_system.go 08bc950d44 Add experimental internal SMB server to arozos (#313) il y a 1 semaine
file_system.share.go a8ca1470b0 Show sharer as owner of files on share:/ drive il y a 3 semaines
file_system_preference_test.go 573be4fa61 Restructure Storage Pool architecture il y a 1 semaine
file_system_share_test.go a8ca1470b0 Show sharer as owner of files on share:/ drive il y a 3 semaines
file_system_task_test.go 9753525836 Make zip and unzip responsive to pause/cancel il y a 3 semaines
file_system_trash_test.go dee86e2296 Move trash to a single root .trash folder il y a 3 semaines
file_system_vpath_test.go d241b540a2 Clarify cluster volume and virtual path IDs il y a 1 mois
flags.go 08bc950d44 Add experimental internal SMB server to arozos (#313) il y a 1 semaine
go.mod 49df792fb3 Update go.mod il y a 3 semaines
go.sum f31b03ae85 Add experimental email client il y a 1 mois
hardware.power.go f6e8875a97 V2.020 (#161) il y a 2 ans
ldap.go a9d3ac3c0f V2.025 (#202) il y a 11 mois
locale.fonts.go 0d3dc565fa Add System font library support il y a 3 semaines
locale.go cef35f702a Add system font library and move locale files il y a 4 semaines
main.go 40f8de034b Revamp FTP and SFTP server management il y a 1 semaine
main.router.go b7d65cafda Add setup wizard and module controls il y a 1 semaine
mediaServer.go a0bdedbc44 Harden HLS streaming and MSE recovery il y a 1 mois
meetroom.go c33bf185d7 Add raised hand feature, connection stats, and host kick capability (#292) il y a 3 mois
module.go b7d65cafda Add setup wizard and module controls il y a 1 semaine
module.util.go 3015dff91e Add gcode support to 3D viewer il y a 3 mois
network.forward.go b3cbca2f38 v2.0 Release (#129) il y a 3 ans
network.go 40f8de034b Revamp FTP and SFTP server management il y a 1 semaine
notification.go aaca7eaf10 Notification Agent implementation (#283) il y a 4 mois
notification_settings.go 373ec1fdbe Overhaul file sharing with secure multi-link il y a 1 mois
oauth.go baa3992364 V2.026 (#254) il y a 5 mois
permission.go baa3992364 V2.026 (#254) il y a 5 mois
quota.go baa3992364 V2.026 (#254) il y a 5 mois
register.go a9d3ac3c0f V2.025 (#202) il y a 11 mois
scheduler.go baa3992364 V2.026 (#254) il y a 5 mois
security.go baa3992364 V2.026 (#254) il y a 5 mois
setting.advance.go b3cbca2f38 v2.0 Release (#129) il y a 3 ans
setting.go 6b53644c31 Remove IoT Hub; localize settings pages il y a 3 semaines
setting_test.go 68c3c1f2dc Redesign System Settings il y a 4 semaines
setupwizard.go b7d65cafda Add setup wizard and module controls il y a 1 semaine
setupwizard_test.go b7d65cafda Add setup wizard and module controls il y a 1 semaine
sharedspace.go 1416ed20d1 V3.0.1 -> V3.0.2 (#278) il y a 4 mois
smbserver.go f1f797acc4 Disable SMB server on Windows il y a 1 semaine
start.sh 5bb5be8ee6 Updates v1.113 il y a 5 ans
startup.flags.go 68c3c1f2dc Redesign System Settings il y a 4 semaines
startup.flags_test.go 68c3c1f2dc Redesign System Settings il y a 4 semaines
startup.go b7d65cafda Add setup wizard and module controls il y a 1 semaine
storage.access.go 573be4fa61 Restructure Storage Pool architecture il y a 1 semaine
storage.go 573be4fa61 Restructure Storage Pool architecture il y a 1 semaine
storage.pool.go 7354c6afc6 Fixed storage pool reload SMB conn stop bug il y a 1 semaine
storage_pool_test.go 573be4fa61 Restructure Storage Pool architecture il y a 1 semaine
subservice.go d18df0d902 Add container apps and office fixes il y a 1 mois
system.go baa3992364 V2.026 (#254) il y a 5 mois
system.info.go 68c3c1f2dc Redesign System Settings il y a 4 semaines
system.resetpw.go baa3992364 V2.026 (#254) il y a 5 mois
test.go baa3992364 V2.026 (#254) il y a 5 mois
user.go b7d65cafda Add setup wizard and module controls il y a 1 semaine
wifi.go 369b05c9b1 Rework WiFi: native WLAN API, rich scan data, new UI il y a 1 mois

README.md

ArozOS 2.0

This is the go implementation of ArozOS (aka ArOZ Online) Web Desktop environment,designed to run on linux, but somehow still works on Windows and Mac OS

This README file is intended for developer only. If you are normal users, please refer to the README file outside of the /src folder.

Development Notes

  • Start each module with {ModuleName}Init() function, e.g. WiFiInit()
  • Put your function in mod (if possible) and call it in the main program
  • Do not change the sequence in the startup() function unless necessary
  • When in doubt, add startup flags (and use startup flag to disable experimental functions on startup)

Vendor Resources Overwrite

If you want to overwrite vendor related resources in ArozOS 2.012 or above, create a folder in the system root named vendor-res and put the replacement files inside here. Here is a list of supported replacement resources files

Filename Recommended Format Usage
auth_bg.jpg 2938 x 1653 px Login Wallpaper
auth_icon.png 5900 x 1180 px Authentication Page Logo
vendor_icon.png 1560 x 600 px Vendor Brand Icon

(To be expanded)

File System Virtualization and File System Abstractions Layers

The ArozOS system contains both the virtualization layer and abstraction layer. The easiest way to check if your path is under which layer is by looking at their starting dir name.

Path Structure Example Path Layer
{vroot_id}:/{subpath} user:/Desktop/myfile.txt File System Virtualization Layer (Highest Layer)
fsh (*File System Handler) + subpath (string) fsh (localfs) + /files/users/alan/Desktop/myfile.txt File System Abstraction
{physical_location}/{subpath} /home/aroz/arozos/files/users/Desktop/myfile.txt Physical (Disk) Layer

Since ArozOS v2.000, we added File System Abstraction (fsa, or sometime as seen as fshAbs, abbr for "File System Handler underlaying File System Abstraction) to the (already complex) File System Handler (fsh) infrastruture. There are two type of fsh that are currently supported by ArozOS File System Abstraction layer.

ArOZ JavaScript Gateway Interface / Plugin Loader

The ArOZ AJGI / AGI interface provide a JavaScript programmable interface for ArozOS users to create plugin for the system. To initiate the module, you can place a "init.agi" file in the web directory of the module (also named the module root). See more details in the agi-doc.md

AGI script can be run as different scope and permissions.

Scope Usable Functions
WebApp startup script (init.agi) System Functions and Registrations
WebApp contained scripts System Functions and User Functions
Others (Web Root / Serverless / Scheduler) System Functions, User Functions ( with script register owner scope) and serverless

Subservice Logics and Configuration

To intergrate other binary based web server to the subservice interface, you can create a folder inside the "./subservice/your_service" where your binary executable should be named identically with the containing directory. For example, you have a module that provides web ui named "demo.exe", then your should put the demo.exe into "./subservice/demo/demo.exe".

In the case of Linux environment, the subservice routine will first if the module is installed via apt-get by checking with the "which" program. (If you got busybox, it should be built in) If the package is not found in the apt list, the binary of the program will be searched under the subservice directory.

Please follow the naming convention given in the build.sh template. For example, the corresponding platform will search for the corresponding binary excitable filename:

demo_linux_amd64    => Linux AMD64
demo_linux_arm      => Linux ARMv6l / v7l
demo_linux_arm64    => Linux ARM64
demo_macOS_amd64    => MacOS AMD64 

Startup Flags

During the startup of the subservice, two types of parameter will be passed in. Here are the examples

demo.exe -info
demo.exe -port 12810 -rpt "http://localhost:8080/api/ajgi/interface"

In the case of receiving the "info" flag, the program should print the JSON string with correct module information as stated in the struct below.

//Struct for storing module information
type serviecInfo struct{
    Name string                //Name of this module. e.g. "Audio"
    Desc string                //Description for this module
    Group string            //Group of the module, e.g. "system" / "media" etc
    IconPath string            //Module icon image path e.g. "Audio/img/function_icon.png"
    Version string            //Version of the module. Format: [0-9]*.[0-9][0-9].[0-9]
    StartDir string         //Default starting dir, e.g. "Audio/index.html"
    SupportFW bool             //Support floatWindow. If yes, floatWindow dir will be loaded
    LaunchFWDir string         //This link will be launched instead of 'StartDir' if fw mode
    SupportEmb bool            //Support embedded mode
    LaunchEmb string         //This link will be launched instead of StartDir / Fw if a file is opened with this module
    InitFWSize []int         //Floatwindow init size. [0] => Width, [1] => Height
    InitEmbSize []int        //Embedded mode init size. [0] => Width, [1] => Height
    SupportedExt []string     //Supported File Extensions. e.g. ".mp3", ".flac", ".wav"
}

//Example Usage when reciving the -info flag
infoObject := serviecInfo{
        Name: "Demo Subservice",
        Desc: "A simple subservice code for showing how subservice works in ArOZ Online",            
        Group: "Development",
        IconPath: "demo/icon.png",
        Version: "0.0.1",
        //You can define any path before the actualy html file. This directory (in this case demo/ ) will be the reverse proxy endpoint for this module
        StartDir: "demo/home.html",            
        SupportFW: true, 
        LaunchFWDir: "demo/home.html",
        SupportEmb: true,
        LaunchEmb: "demo/embedded.html",
        InitFWSize: []int{720, 480},
        InitEmbSize: []int{720, 480},
        SupportedExt: []string{".txt",".md"},
    }

jsonString, _ := json.Marshal(info);
fmt.Println(string(infoObject))
os.Exit(0);

When receiving the port flag, the program should start the web ui at the given port. The following is an example for the implementation of such functionality.

var port = flag.String("port", ":80", "The default listening endpoint for this subservice")
flag.Parse()
err := http.ListenAndServe(*port, nil)
if err != nil {
    log.Fatal(err)
}

Subservice Exec Settings

In default, subservice routine will create a reverse proxy with URL rewrite build in that serve your web ui launched from the binary executable. If you do not need a reverse proxy connection, want a custom launch script or else, you can use the following setting files.

.noproxy        => Do not start a proxy to the given port
.startscript    => Send the launch parameter to the "start.bat" or "start.sh" file instead of the binary executable
.disabled        => Do not load this subservice during startup. But the user can enable it via the setting interface

Here is an example "start.bat" used in integrating Syncthing into ArOZ Online System with ".startscript" file placed next to the syncthing.exe file.

if not exist ".\config" mkdir ".\config"
syncthing.exe -home=".\config" -no-browser -gui-address=127.0.0.1%2

Systemd support

To enable systemd in your host that support aroz online system, create a bash script at your aroz online root named "start.sh" and fill it up with your prefered startup paratmers. The most basic one is as follow:

#/bin/bash
sudo ./aroz_online_linux_amd64

And then you can create a new file called "arozos.service" in /etc/systemd/system with the following contents (Assume your aroz online root is at /home/pi/arozos)

[Unit]
Description=ArozOS Cloud Desktop Service.

[Service]
Type=simple
WorkingDirectory=/home/pi/arozos/
ExecStart=/bin/bash /home/pi/arozos/start.sh

Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Finally to enable the service, use the following systemd commands

#Enable the script during the startup process
sudo systemctl enable arozos.service

#Start the service now
sudo systemctl start arozos.service

#Show the status of the service
systemctl status arozos.service


#Disable the service if you no longer want it to start during boot
sudo systemctl disable aroz-online.service