mirror-chatterino2/README.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

63 lines
3.1 KiB
Markdown
Raw Permalink Normal View History

2023-10-04 12:44:35 +02:00
![chatterinoLogo](https://user-images.githubusercontent.com/41973452/272541622-52457e89-5f16-4c83-93e7-91866c25b606.png)
2021-05-14 11:59:47 +02:00
Chatterino 2 [![GitHub Actions Build (Windows, Ubuntu, MacOS)](https://github.com/Chatterino/chatterino2/workflows/Build/badge.svg?branch=master)](https://github.com/Chatterino/chatterino2/actions?query=workflow%3ABuild+branch%3Amaster) [![Cirrus CI Build (FreeBSD only)](https://api.cirrus-ci.com/github/Chatterino/chatterino2.svg?branch=master)](https://cirrus-ci.com/github/Chatterino/chatterino2/master) [![Chocolatey Package](https://img.shields.io/chocolatey/v/chatterino?include_prereleases)](https://chocolatey.org/packages/chatterino) [![Flatpak Package](https://img.shields.io/flathub/v/com.chatterino.chatterino)](https://flathub.org/apps/details/com.chatterino.chatterino)
============
Chatterino 2 is a chat client for [Twitch.tv](https://twitch.tv).
2020-09-25 20:42:27 +02:00
The Chatterino 2 wiki can be found [here](https://wiki.chatterino.com).
Contribution guidelines can be found [here](https://wiki.chatterino.com/Contributing%20for%20Developers).
2019-08-21 22:12:55 +02:00
## Download
2021-02-21 14:45:42 +01:00
2019-08-21 22:12:55 +02:00
Current releases are available at [https://chatterino.com](https://chatterino.com).
Windows users can also install Chatterino [from Chocolatey](https://chocolatey.org/packages/chatterino).
2019-08-21 22:12:55 +02:00
## Nightly build
2021-02-21 14:45:42 +01:00
You can download the latest Chatterino 2 build over [here](https://github.com/Chatterino/chatterino2/releases/tag/nightly-build)
2018-06-22 13:18:12 +02:00
You might also need to install the [VC++ Redistributables](https://aka.ms/vs/17/release/vc_redist.x64.exe) from Microsoft if you do not have it installed already.
2021-02-21 14:45:42 +01:00
If you still receive an error about `MSVCR120.dll missing`, then you should install the [VC++ 2013 Restributable](https://download.microsoft.com/download/2/E/6/2E61CFA4-993B-4DD4-91DA-3737CD5CD6E3/vcredist_x64.exe).
2018-06-22 13:18:12 +02:00
## Building
2021-02-21 14:45:42 +01:00
To get source code with required submodules run:
2021-02-21 14:45:42 +01:00
```shell
git clone --recurse-submodules https://github.com/Chatterino/chatterino2.git
```
2021-02-21 14:45:42 +01:00
or
2021-02-21 14:45:42 +01:00
```shell
git clone https://github.com/Chatterino/chatterino2.git
cd chatterino2
git submodule update --init --recursive
```
- [Building on Windows](../master/BUILDING_ON_WINDOWS.md)
- [Building on Windows with vcpkg](../master/BUILDING_ON_WINDOWS_WITH_VCPKG.md)
- [Building on Linux](../master/BUILDING_ON_LINUX.md)
- [Building on macOS](../master/BUILDING_ON_MAC.md)
- [Building on FreeBSD](../master/BUILDING_ON_FREEBSD.md)
## Git blame
This project has big commits in the history which touch most files while only doing stylistic changes. To improve the output of git-blame, consider setting:
```shell
git config blame.ignoreRevsFile .git-blame-ignore-revs
```
This will ignore all revisions mentioned in the [`.git-blame-ignore-revs`
file](./.git-blame-ignore-revs). GitHub does this by default.
## Code style
2021-02-21 14:45:42 +01:00
The code is formatted using [clang-format](https://clang.llvm.org/docs/ClangFormat.html). Our configuration is found in the [.clang-format](.clang-format) file in the repository root directory.
2018-05-25 17:19:02 +02:00
For more contribution guidelines, take a look at [the wiki](https://wiki.chatterino.com/Contributing%20for%20Developers/).
2019-05-18 21:33:16 +02:00
2019-10-03 22:20:55 +02:00
## Doxygen
2021-02-21 14:45:42 +01:00
2019-10-03 22:20:55 +02:00
Doxygen is used to generate project information daily and is available [here](https://doxygen.chatterino.com).