AP-Sensing / ostree-tui

Terminal User Interface for OSTree

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

OSTree-TUI

A terminal user interface for OSTree.

ostree-tui preview


Report a Bug · Request a Feature · Fork the Repo · Submit a Pull Request


Welcome to OSTree-TUI. This project provides a more user friendly approach to a OSTree interface. It's purpose is to assist developers when using the command line to interact with OSTree (not to replace the command line interface completely).

Usage & Features

To start the OSTree-TUI, simply type ostree-tui <repo_path> (replace <repo_path> with the path to the desired repository), or ostree-tui --help to see its options. Navigating the application is possible with the arrow keys, or mouse input. Special actions are described in the bottom-bar.

The features currently include:

  • Display a commit tree on the left
  • Branch filter options on the top right
  • Display details to the selected commit on the right

Upcoming features can be viewed in the issues!

Installation / Build instructions

Normal build:

To build OSTree-TUI on your system, just execute the following steps:

  1. Clone the repository:
git clone git@github.com:AP-Sensing/ostree-tui.git
# or use https://github.com/AP-Sensing/ostree-tui.git if you haven't set up your ssh-key
cd ostree-tui
  1. Build with CMake (requires you to have ostree installed on your system, just follow the error messages):
mkdir build
cd build
cmake ..
cmake --build . --parallel
# The binary will be located in `./bin/ostree-tui`.
# To install, use `make install DESTDIR=<target_destination>`

Webassembly build:

The Webassembly build has not been tested, or confirmed yet.

mkdir build_emscripten && cd build_emscripten
emcmake cmake ..
make -j
./run_webassembly.py
(visit localhost:8000)

About

Terminal User Interface for OSTree

License:GNU General Public License v3.0


Languages

Language:C++ 84.0%Language:CMake 8.2%Language:HTML 4.0%Language:Shell 2.9%Language:Python 1.0%