Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/reineimi/va2
V A 二ｌｌA (Vanilla Project or Va2) is a webserver-based (Apache2) Desktop Environment application with a variety of native modules, libraries and extensions.
https://github.com/reineimi/va2
apache2 backend desktop-environment filesystem fileviewer frontend javascript lua quicklook vanilla web-application web-server
Last synced: 24 days ago
JSON representation
V A 二ｌｌA (Vanilla Project or Va2) is a webserver-based (Apache2) Desktop Environment application with a variety of native modules, libraries and extensions.
- Host: GitHub
- URL: https://github.com/reineimi/va2
- Owner: reineimi
- License: other
- Created: 2024-06-20T12:50:35.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-10-21T03:59:25.000Z (27 days ago)
- Last Synced: 2024-10-22T04:17:19.929Z (26 days ago)
- Topics: apache2, backend, desktop-environment, filesystem, fileviewer, frontend, javascript, lua, quicklook, vanilla, web-application, web-server
- Language: JavaScript
- Homepage: https://reineimi.github.io/va2/
- Size: 1.83 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[Click for demo](https://reineimi.github.io/va2/)
> Please note that the Github Pages demo is not going to work as expected, as it requires a webserver
> for handshakes between the Operating System and the frontend of this web application.
## Content:
- [Introduction](https://github.com/reineimi/va2/tree/main?tab=readme-ov-file#introduction)
- [Installation](https://github.com/reineimi/va2/tree/main?tab=readme-ov-file#installation)
- [Screenshots](https://github.com/reineimi/va2/tree/main?tab=readme-ov-file#screenshots)
- [Configuration](https://github.com/reineimi/va2/tree/main?tab=readme-ov-file#configuration)
- [Module embedding](https://github.com/reineimi/va2/tree/main?tab=readme-ov-file#module-embedding)
# Introduction
V A 二ｌｌA (`Vanilla Project` or `Va2`) is a webserver-based (Apache2) Desktop Environment application.
It is made to be flexible and cross-platform, however currently focused on Linux machines only.
Being under development it does not have a lot of features; however, there is a lot of native features and
applications that have already been scheduled for development.
# Installation
The only requirement for this application is `Apache webserver`, which can be:
- [Downloaded for Windows](https://www.apachelounge.com/download/)
- [Compiled from source](https://httpd.apache.org/download.cgi)
- Or installed as a package, for example:
```
(Arch Linux)
sudo pacman -Syy apache
(Ubuntu Linux)
sudo apt install apache2
(Termux, Android)
pkg install apache2
```
# Screenshots
### Alpha ver. GUI: Light mode
### Alpha ver. GUI: Dark mode
# Configuration
Create a new folder called `va2.reineimi` in the `./htdocs` (Windows) or `./http` (Arch Linux) directory of your Apache version, then put the contents of this application inside of that folder;
Change your host **username** and **paths** in the following files:
> (the paths in the examples below are genuine for Arch Linux and doesn't have to be changed on those OS distributions)
`httpd.conf`
```conf
Define _ROOT "/etc/httpd"
Define _DOCS "/srv/http"
Define _LOGS "/srv/http/logs"
...
# Server user for Linux
User _USERNAME_
...
```
`response.lua`
```lua
USER = '_USERNAME_'
PATH = '/srv/http/va2.reineimi/'
...
WIN_HTTPD_PATH = 'C:\\Apache24\\bin'
```
`server.conf`
```json
{
"server_path": "/srv/http/va2.reineimi/",
"server_user": "_USERNAME_",
"downloads": "/home/_USERNAME_/Downloads/"
}
```
Then put `httpd.conf` in, presumably, one of these locations (where the old `httpd.conf` can be found):
`C:/Apache24/conf/` (Windows);
`/etc/httpd/` (Arch Linux).
# Module embedding
To embed any library module, for example `va2.js` and `va2.css`, you only need to put the following in your `` tag:
```html
```
It's also recommended to include the following meta tag:
```html
```
And replace `CURRENT_VER` with the Va2 version you can see in your console once `va2.js` loaded.
This meta tag allows you to track significant releases and whether it's recommended to update your local files immediately or not.