ansible-os/README.md

# OS Configuration

Ansible roles for configuring Linux and MacOS environments.

## License

[GNU General Public License v3.](https://www.gnu.org/licenses/gpl-3.0.html)

## Usage

```
# Create README.md:
$ make doc

# Configure local OS:
$ make
```

----

## Configuration files and scripts

- [shellrc](https://code.envrm.info/src/shellrc) - Configuration files for shells (bash, tclsh, etc), X, WM and applications.
- [scripts-linux](https://code.envrm.info/src/scripts-linux) - Various cli scripts.

----

## Common Applications

- [ansible](https://www.ansible.com/) - Automate deployment, configuration, and upgrading.
- [antiword](http://www.winfield.demon.nl/) - Utility to read Word (.doc) files.
- [dfc](https://projects.gw-computing.net/projects/dfc) - Display graphs and colors of file system space/usage.
- [docx2txt](https://docx2txt.sourceforge.io/) - Converts Microsoft Office docx documents to equivalent text documents.
- [exiftool](https://www.sno.phy.queensu.ca/~phil/exiftool/index.html) - Perl lib for reading and writing EXIF metadata.
- [firefox](https://www.mozilla.org/ru/firefox/) - Mozilla Firefox.
- [ghostscript](https://www.ghostscript.com/) - Interpreter for PostScript and PDF.
- [haskell-stack](https://haskellstack.org/) - The Haskell Tool Stack.
- [hstr](https://github.com/dvorka/hstr) - Bash and zsh history suggest box.
- [htop](https://hisham.hm/htop/) - Improved top (interactive process viewer).
- [imagemagick](https://www.imagemagick.org/) - Tools and libraries to manipulate images in many formats.
- [jq](https://stedolan.github.io/jq/) - Lightweight and flexible command-line JSON processor.
- [neovim](https://neovim.io/) - Ambitious Vim-fork focused on extensibility and agility.
- [nnn](https://github.com/jarun/nnn) - Tiny, lightning fast, feature-packed file manager.
- [ntfs-3g](https://www.tuxera.com/community/open-source-ntfs-3g/) - Read-write NTFS driver for FUSE.
- [shellcheck](https://www.shellcheck.net/) - Static analysis and lint tool, for (ba)sh scripts.
- [tcl](https://tcl.tk) - TCL Programming language.
- [tree](http://mama.indstate.edu/users/ice/tree/) - Display directories as trees (with optional color/HTML output).
- [unrar](https://www.rarlab.com/) - Extract, view, and test RAR archives.
- [vifm](https://vifm.info/) - Ncurses based file manager with vi like keybindings.

## Linux

### Applications

- [docker](https://www.docker.com/) - Pack, ship and run any application as a lightweight container.
- ~~[odt2txt](https://github.com/dstosberg/odt2txt/) - Convert OpenDocument files to plain text.~~
- [sdcv](https://dushistov.github.io/sdcv/) - Console version of StarDict.
- [zathura](https://pwmt.org/projects/zathura/) - A document viewer.
- ~~[hlint](https://github.com/ndmitchell/hlint) - **[BIN]** Haskell source code suggestions.~~
- [tk](https://tcl.tk) - GUI ToolKit for TCL Programming language.
- [neomutt](https://neomutt.org/) - Command line mail reader (or MUA). It’s a fork of Mutt with added features.
- [procmail](http://www.procmail.org/) - Mail delivery agent.
- [geeqie](http://www.geeqie.org/) - lightweight image viewer for Linux, BSDs and compatibles.
- [sxiv](https://github.com/muennich/sxiv) - Simple X Image Viewer.
- [mpc](https://musicpd.org/clients/mpc/) - A minimalist command line interface to MPD.
- [mpd](https://www.musicpd.org/) - Flexible, powerful, server-side application for playing music.
- [ncmpcpp](https://rybczak.net/ncmpcpp/) - NCurses Music Player Client (Plus Plus).
- [mpv](https://mpv.io/) - Free, open source, and cross-platform media player
- ~~[vlc](https://www.videolan.org/vlc/) - VLC media player.~~
- [sshfs](https://github.com/libfuse/sshfs) - A network filesystem client to connect to SSH servers.
- [fetchmail](https://www.fetchmail.info) - Full-featured, robust, well-documented remote-mail retrieval and forwarding utility.
- [aria2](https://aria2.github.io) - Lightweight multi-protocol & multi-source command-line download utility.
- [connman](https://01.org/connman) - Internet connection daemon.
- ~~[bat](https://github.com/sharkdp/bat) - **[BIN]** Clone of cat(1) with syntax highlighting and Git integration.~~
- ~~[fd](https://github.com/sharkdp/fd) - **[BIN]** Simple, fast and user-friendly alternative to find.~~
- ~~[ripgrep](https://github.com/BurntSushi/ripgrep) - **[BIN]** Search tool like grep and The Silver Searcher.~~
- [dmenu](https://tools.suckless.org/dmenu/) - Fast and lightweight dynamic menu for X.
- [polybar](https://polybar.github.io/) - A fast and easy-to-use status bar.
- [rofi](https://github.com/davatorium/rofi) - A window switcher, application launcher and dmenu replacement.
- [tabbed](https://tools.suckless.org/tabbed/) - Simple generic tabbed fronted to xembed aware applications.
- [wmctrl](https://sites.google.com/site/tstyblo/wmctrl) - Command line tool to interact with an EWMH/NetWM compatible X Window Manager.
- [xclip](https://github.com/astrand/xclip) - Command line interface to the X11 clipboard.
- [st](https://st.suckless.org) - Simple terminal implementation for X.
- [bspwm](https://github.com/baskerville/bspwm) - A tiling window manager based on binary space partitioning.

## MacOS

### Applications

- [android-file-transfer](https://www.android.com/filetransfer/) - Android File Transfer.
- [ansible-lint](https://github.com/ansible/ansible-lint/) - Checks ansible playbooks for practices and behaviour.
- [bash](https://www.gnu.org/software/bash/) - Bourne-Again SHell, a UNIX command interpreter.
- [bat](https://github.com/sharkdp/bat) - Clone of cat(1) with syntax highlighting and Git integration.
- [brave-browser](https://brave.com/) - Brave web browser.
- [coreutils](https://www.gnu.org/software/coreutils) - GNU File, Shell, and Text utilities.
- [curl](https://curl.haxx.se/) - Get a file from an HTTP, HTTPS or FTP server.
- [dash](https://kapeli.com/dash) - Documentation viewer.
- ~~[deepl](https://www.deepl.com/) - DeepL translator.~~
- ~~[devdocs-macos](https://github.com/egoist/devdocs-desktop) - A full-featured desktop app for DevDocs.io.~~
- [dive](https://github.com/wagoodman/dive) - Tool for exploring each layer in a docker image.
- [djvu2pdf](https://0x2a.at/site/projects/djvu2pdf/) - Small tool to convert Djvu files to PDF files.
- ~~[docker](https://www.docker.com/) - Pack, ship and run any application as a lightweight container.~~
- [eslint](https://eslint.org) - AST-based pattern checker for JavaScript.
- [fd](https://github.com/sharkdp/fd) - Simple, fast and user-friendly alternative to find.
- [findutils](https://www.gnu.org/software/findutils/) - Collection of GNU find, xargs, and locate.
- [gawk](https://www.gnu.org/software/gawk/) - GNU awk utility.
- ~~[gimp](https://www.gimp.org/) - GNU Image Manipulation Program.~~
- [git-cal](https://github.com/k4rthik/git-cal) - GitHub-like contributions calendar but on the command-line.
- [git-delta](https://github.com/dandavison/delta) - Syntax-highlighting pager for git and diff output.
- [git](https://git-scm.com) - Distributed revision control system.
- [glow](https://github.com/charmbracelet/glow) - Render markdown on the CLI.
- [go](https://golang.org) - Programming language to build simple/reliable/efficient software.
- ~~[guile](https://www.gnu.org/software/guile/) - GNU Ubiquitous Intelligent Language for Extensions.~~
- [hadolint](https://github.com/hadolint/hadolint) - Smarter Dockerfile linter to validate best practices.
- [hlint](https://github.com/ndmitchell/hlint) - Haskell source code suggestions.
- [httpie](https://httpie.org/) - User-friendly cURL replacement (command-line HTTP client).
- [hyperfine](https://github.com/sharkdp/hyperfine) - Command-line benchmarking tool.
- [ipcalc](http://jodies.de/ipcalc) - Calculate various network masks, etc. from a given IP address.
- [iterm2](https://www.iterm2.com/) - Terminal emlator.
- [joplin](https://joplinapp.org/) - An open source note taking and to-do application.
- ~~[mdcat](https://github.com/lunaryorn/mdcat) - Show markdown documents on text terminals.~~
- [nativefier](https://github.com/jiahaog/nativefier) - Wrap web apps natively.
- [odt2txt](https://github.com/dstosberg/odt2txt/) - Convert OpenDocument files to plain text.
- ~~[osquery](https://osquery.io) - SQL powered operating system instrumentation and analytics.~~
- [osxfuse](https://osxfuse.github.io/) - FUSE for MacOS.
- [p7zip](https://p7zip.sourceforge.io/) - 7-Zip (high compression file archiver) implementation.
- [pandoc](https://pandoc.org/) - Swiss-army knife of markup format conversion.
- [pdftotext](https://www.bluem.net/en/mac/) - PDF to text convertor.
- [polar-bookshelf](https://getpolarized.io/) - Document manager for web pages, textbooks, PDFs, etc.
- [qlcolorcode](https://github.com/anthonygelibert/QLColorCode) - QuickLook plugin for source code with syntax highlighting.
- [qlmarkdown](https://github.com/toland/qlmarkdown) - QuickLook generator for Markdown files.
- [qlstephen](https://whomwah.github.io/qlstephen/) - QuickLook plugin to view plain text files without a file extension.
- [qlvideo](https://github.com/Marginal/QLVideo) - QuickLook plugin to preview video files.
- [quicklook-json](http://www.sagtau.com/quicklookjson.html) - QuickLook plugin to preview JSON files.
- [ripgrep](https://github.com/BurntSushi/ripgrep) - Search tool like grep and The Silver Searcher.
- [rlwrap](https://github.com/hanslub42/rlwrap) - Readline wrapper: adds readline support to tools that lack it. Dependency of cheat.sh.
- [telegram](https://macos.telegram.org/) - Telegram for MacOS.
- [tig](https://jonas.github.io/tig/) - Text interface for Git repositories.
- ~~[timing](https://timingapp.com/) - 💰 Time tracker for MacOS.~~
- [transmission](https://transmissionbt.com/) - BitTorrent client.
- [tunnelblick](https://www.tunnelblick.net/) - Graphic user interface for OpenVPN.
- [typora](https://typora.io/) - Distractions free markdown editor.
- [vimr](http://vimr.org/) - VimR.
- [vlc](https://www.videolan.org/vlc/) - VLC media player.
- [w3m](https://w3m.sourceforge.io/) - Pager/text based browser.
- [webp](https://developers.google.com/speed/webp/) - Image format providing lossless and lossy compression for web images.
- [webpquicklook](https://github.com/emin/WebPQuickLook) - QuickLook plugin for WebP image files.
- [wget](https://www.gnu.org/software/wget/) - Internet file retriever.
- [xmind-zen](https://www.xmind.net/zen/) - Mind-mapping tool.
- [xnviewmp](https://www.xnview.com/) - Image viewer.

### Other

- [Keyman](https://keyman.com/mac/download) - Input method and screen keyboard for more than 1000 languages.