https://github.com/vanilla-os/vanilla-system-operator

VSO is an utility which allows you to perform maintenance tasks on your Vanilla OS installation.
https://github.com/vanilla-os/vanilla-system-operator

command-line hacktoberfest package-manager system-operator tasks-manager vanillaos

Last synced: about 2 months ago
JSON representation

VSO is an utility which allows you to perform maintenance tasks on your Vanilla OS installation.

• Host: GitHub
• URL: https://github.com/vanilla-os/vanilla-system-operator
• Owner: Vanilla-OS
• License: gpl-3.0
• Created: 2022-11-28T08:47:44.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-05-21T14:59:52.000Z (8 months ago)
• Last Synced: 2024-05-21T17:02:12.718Z (8 months ago)
• Topics: command-line, hacktoberfest, package-manager, system-operator, tasks-manager, vanillaos
• Language: Go
• Homepage:
• Size: 4.85 MB
• Stars: 25
• Watchers: 2
• Forks: 10
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: COPYING.md

Awesome Lists containing this project

README

        


  

  
Vanilla System Operator

	

[![Translation Status][weblate-image]][weblate-url]


[weblate-url]: https://hosted.weblate.org/engage/vanilla-os/

[weblate-image]: https://hosted.weblate.org/widget/vanilla-os/vanilla-system-operator/svg-badge.svg

 

  
VSO is a utility which allows you to perform maintenance tasks on your Vanilla OS installation.






## Help

```md

The Vanilla System Operator is a package manager, a system updater and a task automator.

Usage:

  vso [command]

Available Commands:

  android     Manage the vso waydroid subsystem

  completion  Generate the autocompletion script for the specified shell

  config      Manage the system configuration.

  export      Export an application or binary from the subsystem

  help        Help about any command

  install     Install an application inside the subsystem

  pico-init   Initialize the VSO subsystem, used for package management

  remove      Remove an application from the subsystem

  run         Run an application from the subsystem

  search      Search for an application to install inside the subsystem

  shell       Enter the subsystem environment

  sideload    Sideload DEB/APK packages inside the subsystem

  sys         Execute system commands, such as upgrading the system

  tasks       Create and manage tasks

  unexport    Unexport an application or binary from the subsystem

  update      Update the subsystem's package repository

  upgrade     Upgrade the packages inside the subsystem

Flags:

  -h, --help      Show help for vso.

  -v, --version   Show version for vso.

Use "vso [command] --help" for more information about a command.

```

## Documentation

The official **documentation and manpage** for `vso` are available at .

## VSO as system Shell

To use VSO as your system shell, you can copy the `usr/bin/vso-os-shell` script

to your system's `/usr/bin` directory and set it as your default shell. Your

image needs to implement the `usr/bin/os-shell` script, which will expand the

`$SHELL` environment variable, this is much needed for login shells and other

flags, this also ensures that the user's default shell is respected.

Our `vso-image` already implements this script.