mirror-chatterino2/README.md

66 lines
3.1 KiB
Markdown
Raw Normal View History

![alt text](https://fourtf.com/img/chatterino-icon-64.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
```
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
```
git clone https://github.com/Chatterino/chatterino2.git
cd chatterino2
git submodule update --init --recursive
```
2018-05-25 17:19:02 +02:00
[Building on Windows](../master/BUILDING_ON_WINDOWS.md)
[Building on Windows with vcpkg](../master/BUILDING_ON_WINDOWS_WITH_VCPKG.md)
2018-05-25 17:19:02 +02:00
[Building on Linux](../master/BUILDING_ON_LINUX.md)
[Building on Mac](../master/BUILDING_ON_MAC.md)
[Building on FreeBSD](../master/BUILDING_ON_FREEBSD.md)
## Code style
2021-02-21 14:45:42 +01:00
The code is formatted using clang format in Qt Creator. [.clang-format](src/.clang-format) contains the style file for clang format.
2018-05-25 17:19:02 +02:00
### Get it automated with QT Creator + Beautifier + Clang Format
2021-02-21 14:45:42 +01:00
1. Download LLVM: https://github.com/llvm/llvm-project/releases/download/llvmorg-15.0.5/LLVM-15.0.5-win64.exe
2018-05-25 17:19:02 +02:00
2. During the installation, make sure to add it to your path
3. In QT Creator, select `Help` > `About Plugins` > `C++` > `Beautifier` to enable the plugin
4. Restart QT Creator
5. Select `Tools` > `Options` > `Beautifier`
6. Under `General` select `Tool: ClangFormat` and enable `Automatic Formatting on File Save`
7. Under `Clang Format` select `Use predefined style: File` and `Fallback style: None`
Qt creator should now format the documents when saving it.
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).