# webos

**Repository Path**: junphine/webos

## Basic Information

- **Project Name**: webos
- **Description**: 桌面风格
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2016-11-09
- **Last Updated**: 2022-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OS.js Version 2.0
OS.js is a light-weight JavaScript based web/cloud desktop solution.

Current version: **Alpha**

*Application API is stable. FS and Handler API is subject to change.*

**If you find any bugs report them back to me and I'll have them squashed**


## Changes

* Completely rewritten (API breakage)
* Easier to extend core and deploy custom builds
* Easier to create custom applications
* Smaller and faster
* Tons of improvements
* Dropped support for legacy browsers
* Runs standalone on any web-server (Filesystem APIs requires using the PHP or Node backend)
* Very simple setup
* No 3rd party libraries (runs on native browser libs)

## Features

* Window Manager
* Desktop Environment
* Session Handling (Support for resuming previous workspaces)
* Package Management (User-installable applications)
* User Management (Custom login and settings storage)
* GUI Library (With Drag-and-drop support)
* Dialog Library
* Supports both Applications and Background-services
* File System functions
* A basic Theme implementation (icons, sounds and CSS styles)
* Multi-user environment support
* Localization and translations

Comes bundeled with the default theme and some applications:
* **Draw** - A simple drawing application
* **File Manager** - File Management
* **Preview** - For viewing images and videos
* **Music Player** - For listening to audio files
* **Process Viewer** - View running processes
* **Textpad** - A notepad-type application
* **Writer** - Richtext editor

*You can easily add more applications by using external repositories. More information on Wiki*

An example repository: [OS.js-v2-extras](https://github.com/andersevenrud/OS.js-v2-extras)

## Demo

You can have a look here: http://osjsv2.0o.no

This site may not always be up to date, and can be unavailable at times.

## Documentation

### Installation

# Installation
Installation only requires a few small steps.

**How to pull code:** `git pull --recursive https://github.com/andersevenrud/OS.js-v2.git`

Links:

* [Installation overview](https://github.com/andersevenrud/OS.js-v2/wiki/Installation-overview)
* [Installation and configuration help](https://github.com/andersevenrud/OS.js-v2/wiki/Installation%20and%20Configuration)
* [Installation without Git](https://github.com/andersevenrud/OS.js-v2/wiki/Installation%20and%20Configuration#installation-without-git)

## Notes

By default OS.js filesystem is restricted to `/opt/OSjs/tmp` and `/opt/OSjs/home`.
Make sure these directories exist and are readable+writable by the running web-server process.

More information on configuring the backend and frontend on Wiki.

*Small Note: OS.js will not run without a web-server unless you modify browser cross-origin settings and update files to load from relative paths.*

### PHP5 With Apache

See `doc/apache.conf` for an example

* Set up an Apache vhost and point to cloned directory (If you have a "web hosting service", you can most likely skip this)
  * Make sure .htaccess is allowed
  * Make sure mod_rewrite is enabled

### PHP5 Internal Web-server
*This is mostly used for debugging and testing purposes (PHP 5.4+)*

* Run `php -S localhost:8000 bin/php-webserver.php`

### Node.js
*Please note that the node server is not finished yet, but is working for development purposes*

* Run `backend/server.js`

### Lighttpd

See `doc/lighttpd.conf` for an example

### General

Source documentation and examples are located in the `doc/` folder.

Everything else is in the GitHub Project Wiki pages (linked below).

## Compability

The backend runs on Mac, BSD and Linux. Frontend only requires a modern browser with HTML5 support.

### Browser support

Runs in any modern browser. Tested:

* **Gecko** Mozilla Firefox
* **WebKit** Google Chrome, Opera, Safari
* Internet Explorer 10+
* Android and iOS is working, but no mobile version is implemented yet

# License
See the `LICENSE` file.

# Links
* [Homepage](http://andersevenrud.github.io/OS.js-v2/)
* [Github Wiki Pages](https://github.com/andersevenrud/OS.js-v2/wiki)
* [Github Project Page](https://github.com/andersevenrud/OS.js-v2)
* [Demo Page](http://osjsv2.0o.no/)
* [Author Homepage](http://andersevenrud.github.io/)
* [Author Blog](http://anderse.wordpress.com)
* [OS.js v1](http://andersevenrud.github.com/OS.js)