X-Git-Url: https://git.quassel-irc.org/?p=quassel.git;a=blobdiff_plain;f=README.md;h=c7b03dc22f8bb6051f75a07c001335585c70c1fd;hp=2c4671876e057dea9b170b592d2c9dadbfa11e18;hb=HEAD;hpb=c2e3479b87e7d0713d302d26fb2d7d01d7b8c9c2 diff --git a/README.md b/README.md index 2c467187..16ac33b6 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ -Quassel IRC [![Linux Build Status](https://travis-ci.org/quassel/quassel.svg?branch=master)](https://travis-ci.org/quassel/quassel) [![Windows Build Status](https://ci.appveyor.com/api/projects/status/github/quassel/quassel?branch=master&svg=true)](https://ci.appveyor.com/project/quassel/quassel/branch/master) +Quassel IRC =============== +[![Quassel CI Build Status][ci-badge]][ci-status-page] + [Quassel IRC][web-home] is a modern, cross-platform, distributed IRC client, meaning that one (or multiple) client(s) can attach to and detach from a central core -- much like the popular combination of screen and a text-based @@ -13,39 +15,48 @@ you are welcome to download and see for yourself! ## Release notes You can find the current release notes on the [Quassel IRC homepage][web-home], -as well as in this repository's [```ChangeLog```][repo-changelog]. +as well as in this repository's [`ChangeLog`][repo-changelog]. + +## Downloading +Official, stable downloads are provided on the [Quassel IRC download page](https://quassel-irc.org/downloads). + +Untested, automated builds are available [for Windows](https://nightly.link/quassel/quassel/workflows/main/master/Windows.zip ) and [for macOS](https://nightly.link/quassel/quassel/workflows/main/master/macOS.zip ). More details at [the nightly.link page](https://nightly.link/quassel/quassel/workflows/main/master ), by `oprypin`. Or, if you are logged in to GitHub, pick any build from the [GitHub Actions tab][ci-status-page]. + +Unofficial builds and testing versions are [contributed by several community members](https://bugs.quassel-irc.org/projects/quassel-irc/wiki#Unofficial-builds). ## Quick reference +We recommend reading the [getting started guide on the wiki](https://bugs.quassel-irc.org/projects/quassel-irc/wiki#Getting-started), +but in a pinch, these steps will do. On first run of the Quassel core, it will wait for a client to connect -and present a first-run wizard that will allow you to create the database -and one admin user for the core-side storage. - -* To add more users, run: ```quasselcore --add-user``` -* To change the password of an existing user: ```quasselcore --change-userpass=username``` +and present a wizard that will allow you to create the database and one admin +user for the core-side storage. -On some systems, you may need to specify ```--configdir```, e.g. -```quasselcore --configdir=/var/lib/quassel [command]```. +Once you've set up Quassel, you may: +* Add more users: `quasselcore --add-user` +* Change the password of an existing user: `quasselcore --change-userpass=username` +* See all available options: `quasselcore --help` -The ```manageusers.py``` script is deprecated and should no longer be used. +On some systems, you may need to specify `--configdir`, e.g. +`quasselcore --configdir=/var/lib/quassel [command]`. -To learn more, see [the Quassel project wiki][docs-wiki] for in-depth +To learn more, see [the Quassel project wiki](https://bugs.quassel-irc.org/projects/quassel-irc/wiki) for in-depth documentation. ## Getting involved IRC is the preferred means of getting in touch with the developers. -The Quassel IRC Team can be contacted on **```Freenode/#quassel```** -(or **```#quassel.de```**). If you have trouble getting Quassel to connect, -you can use [Freenode's webchat][help-freenode]. +The Quassel IRC Team can be contacted on **`Libera Chat/#quassel`** +(or **`#quassel.de`**). If you have trouble getting Quassel to connect, +you can use [Libera Chat's web client](https://web.libera.chat/?channels=#quassel). We always welcome new users in our channels! You can learn more and reach out to us in several ways: * [Visit our homepage][web-home] -* [Submit and browse issues on the bugtracker][dev-bugs] - * Github issues are not used, but [pull requests][dev-pr-new] are accepted! +* [Submit and browse issues on the bugtracker](https://bugs.quassel-irc.org) + * GitHub issues are not used, but [pull requests](https://github.com/quassel/quassel/pull/new/master) are accepted! * [Email the dev team - devel@quassel-irc.org][dev-email] Thanks for reading, @@ -53,9 +64,7 @@ Thanks for reading, ~ *The Quassel IRC Team* [web-home]: https://quassel-irc.org -[dev-bugs]: https://bugs.quassel-irc.org [dev-email]: mailto:devel@quassel-irc.org -[dev-pr-new]: https://github.com/quassel/quassel/pull/new/master -[docs-wiki]: https://bugs.quassel-irc.org/projects/quassel-irc/wiki -[help-freenode]: https://webchat.freenode.net?channels=%23quassel [repo-changelog]: ChangeLog +[ci-badge]: https://github.com/quassel/quassel/workflows/Quassel%20CI/badge.svg?branch=master +[ci-status-page]: https://github.com/quassel/quassel/actions?query=branch%3Amaster