#view #journal #rust

app journalview

A lightweight, terminal-based application written in Rust for efficiently viewing, filtering, and navigating system logs from journalctl

1 unstable release

new 0.1.0 Mar 5, 2025

#2470 in Command line utilities

MIT license

32KB
693 lines

JournalView

A lightweight, terminal-based application written in Rust for efficiently viewing, filtering, and navigating system logs from journalctl.

jview1

Features

  • Log Viewing: Access logs from journalctl logs.
  • Filtering: Powerful filtering capabilities
  • Keyboard Navigation: Intuitive hotkeys for seamless log exploration.
  • Customizable View: Adjust the display for better readability.

Installation

Install Directly (Without Building from Source)

curl -sL https://github.com/codervijo/journalview/raw/main/install.sh | bash

Build From Source

Ensure Rust is installed. You can install Rust using rustup.

cargo install --git https://github.com/codervijo/journalview.git journalview

Usage

Basic Commands

  • Launch the application:

    journalview
    
  • Navigate logs using arrow keys or predefined hotkeys.

Filtering Logs

  • Press / to enter a search query (regex supported).
  • Use Tab to switch between different log sources.

Hotkeys

Key Action
Arrow Up Scroll up in the log list
Arrow Down Scroll down in the log list
Enter Select a log entry
/ Start a search
q Quit the application

Contributing

Contributions are welcome! Follow these steps to contribute:

  1. Fork the repository.
  2. Create a feature branch:
    git checkout -b feature-name
    
  3. Commit your changes:
    git commit -m "Description of changes"
    
  4. Push to your fork:
    git push origin feature-name
    
  5. Open a Pull Request.

Acknoweldgements

Thanks to the following projects for inspiration

License

This project is licensed under the MIT License.

Acknowledgments

Inspired by the functionality of journalctl and enhanced by the capabilities of Rust for high-performance, terminal-based tools.

Dependencies

~8–17MB
~205K SLoC