2018-04-21 14:23:57 +02:00
# bat
2018-04-22 16:08:49 +02:00
[![Build Status ](https://travis-ci.org/sharkdp/bat.svg?branch=master )](https://travis-ci.org/sharkdp/bat)
[![Version info ](https://img.shields.io/crates/v/bat.svg )](https://crates.io/crates/bat)
2018-04-22 15:44:19 +02:00
*A cat(1) clone with wings.*
2018-04-21 14:23:57 +02:00
2018-04-22 15:30:28 +02:00
## Features
### Syntax highlighting
2018-04-26 00:11:10 +02:00
`bat` supports a large number of programming and markup languages (see below):
2018-04-22 15:30:28 +02:00
2018-04-26 00:02:53 +02:00
![Syntax highlighting example ](https://imgur.com/rGsdnDe.png )
2018-04-22 15:30:28 +02:00
### Git integration
2018-04-26 00:12:49 +02:00
`bat` communicates with `git` to show modifications with respect to the index (see left side bar):
2018-04-26 00:02:53 +02:00
2018-04-26 00:03:25 +02:00
![Git integration example ](https://i.imgur.com/2lSW4RE.png )
2018-04-22 16:15:07 +02:00
## Installation
2018-04-26 00:02:53 +02:00
Check out the [Release page ](https://github.com/sharkdp/bat/releases ) for binary builds and Debian packages.
If you want to build to compile `bat` from source, you need Rust 1.22 or higher.
You can then use `cargo` to build everything:
2018-04-25 20:49:49 +02:00
2018-04-24 00:44:39 +02:00
``` bash
2018-04-22 16:15:07 +02:00
cargo install bat
2018-04-26 00:02:53 +02:00
```
2018-04-22 16:15:07 +02:00
2018-04-26 00:02:53 +02:00
### Get themes and syntax highlighting definitions
2018-04-26 00:11:10 +02:00
`bat` uses the excellent [`syntect` ](https://github.com/trishume/syntect/ ) library for syntax highlighting. `syntect` uses Sublime Text language definitions and themes.
To get a big package of languages and a Monokai-variant as a theme, run:
2018-04-26 00:02:53 +02:00
``` bash
2018-04-22 16:15:07 +02:00
mkdir -p ~/.config/bat/themes
cd ~/.config/bat/themes
2018-04-24 00:44:39 +02:00
git clone https://github.com/jonschlinkert/sublime-monokai-extended
ln -s "sublime-monokai-extended/Monokai Extended.tmTheme" Default.tmTheme
mkdir -p ~/.config/bat/syntax
cd ~/.config/bat/syntax
git clone https://github.com/sublimehq/Packages/
rm -rf Packages/Markdown
git clone https://github.com/jonschlinkert/sublime-markdown-extended
2018-04-22 16:15:07 +02:00
```