@c -*- texinfo -*-

@chapter Introduction

@b{BashStyle-NG} is a graphical utility and toolchain for changing the
look, feel, and behavior of @code{Bash}, @code{Readline}, @code{Vim},
@code{Nano}, and @code{Git}. It acts as a central hub to add advanced
features, configuration and visual enhancements into standard command-line
tools, making the terminal environment more user-friendly and powerful.

@float Figure,fig:screenshot_menu
@center @image{screenshots/bashstyle-ng_menu,,, BashStyle-NG UI, png}
@caption{BashStyle-NG main menu}
@end float

The following is a shortened summary of possibilities, see the documentation for more.

@heading Prompt Customization
@itemize @bullet
@item
@b{Prompt Styles:} Includes 12 pre-defined prompt designs which can
be randomized per session or customized.
@item
@b{Custom Prompt Builder:} A modular prompt builder inside the GUI allows users
to create their own custom prompt layouts, or modify the predefined styles.
@item
@b{Color Schemes:} Full control over text and prompt colors, with optional
monochrome modes.
@end itemize

@heading Utility Enhancements
@itemize @bullet
@item
@b{Colored Output:} Allows colored rendering for traditional manpages,
@code{ls}, @code{gcc} error messages and @code{grep} matches.
@item
@b{Directory Tracking:} Features a custom @code{lscd}/@code{treecd} command that
remembers the last visited directory, auto-restores directory on new session,
and prints directory contents immediately after navigating.
@item
@b{Git Status Integration:} dynamically displays the current Git branch, revision,
action, and more straight in the prompt.
@item
@b{History:} customize how many commands the shell remembers, ignores duplicate
entries, and controls how history is written to disk. This includes the options for
@code{history isolation} - meaning that terminal sessions have no outside visible
history. Or the opposite @code{history sync}, when active, reloading the prompt
(pressing enter), will load any new history created from other sessions.
@end itemize

@heading Configuration Management
@itemize @bullet
@item @b{BashStyle-NG} handles it's own configuration through @b{ConfigObj}, all
Text and Number settings have two icons. The left icon (back arrow) reverts to
previously saved user configuration if a setting was changed in the running
@b{BashStyle-NG} instance. The right icon (broom/trash) reverts to the factory
default setting, which is either @b{BashStyle-NG} default setting or a custom
vendor configuration, which can be provided by package maintainers.

@item @b{BashStyle-NG} additionally has global revert buttons at the top, which
act the same way, but for all settings at once, to keep the UI in sync it is
restarted after the configuration was reverted to previous saved user state or
factory default settings.
@end itemize

@float Figure,fig:screenshot_equinox
@center @image{screenshots/bashstyle-ng_equinox,,, Equinox Prompt in Konsole, png}
@caption{Equinox prompt style in Konsole}
@end float

@heading Git repository access

You can check the latest version via @b{GitLab}:

@url{https://gitlab.com/Nanolx/bashstyle-ng}

@heading Translations
@itemize @bullet

@item Existing Translations [Translator]
@itemize @minus

@item de (German) [Christopher Roy Bratušek]
@end itemize

@end itemize

@heading Submit Bugs for Feature Requests

Visit @url{https://gitlab.com/Nanolx/bashstyle-ng/issues} for reporting bugs.

Please make sure that you got the latest stable version of BashStyle-NG. If you
got an Feature Request or a new Idea for BashStyle-NG,  don't hesitate to post
it! If you can provide patches, then that's even better.
