Giter Club home page Giter Club logo

gstreamer-log-viewer's Introduction

GStreamer Log Viewer

Overview

GStreamer Log Viewer is a tool designed to efficiently handle the voluminous debug logs produced during GStreamer debugging sessions. It aids in navigating, categorizing, and analyzing the debug information, making the debugging process smoother and quicker. GStreamer's debugging system generates detailed logs that can be overwhelming; this viewer makes it easier to manage and understand these logs.

GStreamer Log Viewer

GStreamer debug log

To get a debug log file, set environment variables as below:

  • export GST_DEBUG_FILE=gst.log
  • export GST_DEBUG_NO_COLOR=1
  • export GST_DEBUG=5

See Running GStreamer Applications for details.

Features

  • Open Log Files: Easily accessible through the Application menu to open and view logs.
  • Visual Timeline: Logs are displayed in a table format with a visual timeline on the left, enhancing the ease of understanding log sequences.
  • Filtering Options: Filters can be applied in the filter box when enter key is pressed. Column-specific filtering can be done with the format column_name:search_keyword. Unless column is specified, keywords work for Message column
  • Find Functionality: Users can find word through the logs using the find box by entering text and pressing enter to jump.
  • Double-click on:
    • Timestamp : open the line in an externally configured text editor
    • Process, Thread, Level, Category, Source, Function, Object : add [column name]:[current value] to the filter box and apply it
    • Line : open the source code and jump to the corresponding line in an externally configured text editor
    • Message : add current message to the filter box and apply it

Installation

To install GStreamer Log Viewer, follow these steps:

  1. Clone the repository from GitHub at https://github.com/task-jp/gstreamer-log-viewer.
  2. Ensure that Qt 6 is installed as it is a dependency for running the application.
  3. Follow the provided setup instructions to compile and run the viewer.

Usage

After installation, you can start the application via the executable created in the build process. Use the Application menu to open log files and start viewing and filtering GStreamer debug logs. For detailed instructions, refer to the features section above.

Configuration and Customization

Settings for the application can be accessed via Application > Preferences... Here, users can configure:

  • GStreamer Source Directory: Set the local path to the GStreamer source code for integrated source navigation.
  • External Text Editor: Set the path to the external editor for opening log files directly.

Contributing

Contributions are welcome! Please refer to the GitHub repository to report issues, suggest features, or submit pull requests. Follow the standard GitHub flow for collaborating on projects.

License

GStreamer Log Viewer is licensed under the GNU General Public License v2 (GPLv2), which allows for free usage and distribution under certain conditions. For more details, refer to the LICENSE file in the repository.

Contact

For further assistance or to contribute to the project, please visit the project's GitHub page at https://github.com/task-jp/gstreamer-log-viewer.

gstreamer-log-viewer's People

Contributors

task-jp avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.