Skip to content

Latest commit

 

History

History
143 lines (97 loc) · 5.61 KB

README.md

File metadata and controls

143 lines (97 loc) · 5.61 KB
Raw

oma banner: header

oma - Oh My Ailurus / Package Manager for AOSC OS

Features | Install | Contribute

oma is an attempt at reworking APT's interface, making it more user-friendly, more robust against common user errors, and more performant during package downloads. oma also integrates closely with AOSC OS's various system management functions, from mirror configuration, topic (testing) repository enrollment, to system feature protection.

For a more detailed overview on oma's features, see features.

oma is also available for other dpkg-based OS.

Please see Install.

A simple tour of oma

Features

  • Clear-and-Simple Interface: Colorful and TUI-heavy interface, with clear marking for key information and simplified commands for common operations.
  • Faster Downloads: Faster package downloads, powered by the performant reqwest HTTP and multi-threaded downloads.
  • Smart Search: Leveraging the indicium search engine for more relevant package search results.
  • Fool-Proofing Mechanisms: Protection against system failures through a combination of mechanisms - active prevention against removal of essential packages, clear marking for potentially dangerous operations, and a disaster recovery mechanism through undo command.
  • System Feature Protection: Informing and advising against uninstalling critical system components by detecting System Feature Markers in key component packages (AOSC OS only).
  • System Status Integration: Integration with system daemons, allowing oma to warn against performing package management operations on battery power, as well as actively inhibiting accidental reboots and suspends.
  • Compatibility with Other dpkg-based OS: Bringing a more friendly package management experience to major dpkg-based distributions like Debian, Ubuntu, deepin, and openKylin.
  • Distro-specific Integration: Supporting not only AOSC OS-specific features such as topic repository enrollment and mirror management, but also distro-specific services such as Ubuntu Pro.

Dependencies

To build oma, ensure the following dependencies are installed:

During runtime, oma requires or recommends the following:

  • ripgrep (optional, accelerates oma provides, oma files, and oma command-not-found)

Installation

oma is pre-installed with AOSC OS. It is also available for Debian, Ubuntu, Deepin, openKylin, and more dpkg-based OS.

Automatic Installation

curl -sSf https://repo.aosc.io/get-oma.sh | sudo sh

Building from Source

  1. Clone the repository:

    git clone https://github.com/AOSC-Dev/oma.git
cd oma

  2. Build the binary as an installable .deb package:

    cargo deb -Z xz

  3. Install and profit!

Usage

Entering the interactive package management interface

oma # without arguments

Example Commands

  • Installing a package:

    oma install <package_name>

  • Searching for a package:

    oma search <keyword>

  • Removing a package:

    oma remove <package_name>

  • Refreshing repository metadata (done automatically before oma install and oma upgrade):

    oma refresh

For a full list of available sub-commands and arguments, run:

oma help

Command Reference

Command Description
install Install package(s) from the repository
upgrade Upgrade all installed packages
download Download package(s) without installing
remove Remove specified package(s)
refresh Refresh repository metadata
search Search for package(s) in the repository
show Show detailed information for a package
files List files in the specified package
provides Find packages providing specific patterns
fix-broken Fix broken dependencies
pick Install a specific version of package(s)
mark Mark package(s) with a specific status
list List all available packages
depends Show dependencies for package(s)
rdepends Show reverse dependencies for package(s)
clean Clear downloaded package cache
history Show package history or change logs
help Show help of oma or the given subcommand(s)

Contributing

Contributions are welcome!

Please feel free to file issues or pull requests to help improve oma.

Please see CONTRIBUTING for detailed instructions.

License

oma is licensed under the GNU General Public License v3.0. See the COPYING file for details.

oma banner: footer