Lightcord/README.md

113 lines
6.6 KiB
Markdown
Raw Normal View History

2020-06-13 18:36:08 +02:00
[![Discord](https://img.shields.io/discord/705908350218666117?logo=discord&style=flat-square&color=%237289DA)](https://discord.gg/7eFff2A)
![JS](https://img.shields.io/badge/--yellow?logo=javascript&style=flat-square)
![TS](https://img.shields.io/badge/--blue?logo=typescript&style=flat-square)
[![HitCount](http://hits.dwyl.com/Lightcord/Lightcord.svg)](http://hits.dwyl.com/Lightcord/Lightcord)
2020-06-13 18:36:24 +02:00
<br />
[![PayPal](https://img.shields.io/badge/donate-PayPal-blue?logo=PayPal&style=flat-square)](https://paypal.me/jenwina)
[![BTC](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/phorcysed/cryptodonate/master/badges/bitcoin.json&style=flat-square)](https://unixkeys.github.io/cryptodonate/btc.html?address=14hL2fPS2ASoe8Hcif87EqCS5AGHrepGKp&note=https://github.com/phorcysed)
[![CDN](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/phorcysed/cryptodonate/master/badges/cdn.json&style=flat-square)](https://unixkeys.github.io/cryptodonate/cdn.html?address=CbdW3pR4HBWJ6wyc1JeNXP4L2fh8QiL85v&note=https://github.com/phorcysed)
[![BCH](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/phorcysed/cryptodonate/master/badges/bitcoincash.json&style=flat-square)](https://unixkeys.github.io/cryptodonate/bch.html?address=qzqwhfyvkl324fue86r55q656nftfmxkhsn6qugenq&note=https://github.com/phorcysed)
[![XMR](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/phorcysed/cryptodonate/master/badges/monero.json&style=flat-square)](https://unixkeys.github.io/cryptodonate/xmr.html?address=42pGf1KHHpqaifJd3TtWSdcTmhGVwFp24cGxDoqaYLQJ6rH4pM7KqtUdTpoyxHScDTSJpPA2Bnv19b1bs2uPXgSMH2KYkwj&note=https://github.com/phorcysed)
[![ETH](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/phorcysed/cryptodonate/master/badges/ethereum.json&style=flat-square)](https://unixkeys.github.io/cryptodonate/eth.html?address=0xEFE45F22Ee844bf2Ba0E4d853FA0bC8c028fAfFe&note=https://github.com/phorcysed)
[![LTC](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/phorcysed/cryptodonate/master/badges/litecoin.json&style=flat-square)](https://unixkeys.github.io/cryptodonate/ltc.html?address=LNTmfMjHJgTHaB7rj8ZuWWuU1XkP2YeGCA&note=https://github.com/phorcysed)
---
2020-05-16 23:24:51 +02:00
# Lightcord
A simple and customizable Discord client
2020-05-16 23:24:51 +02:00
## What's This?
2020-10-06 13:15:30 +02:00
[Lightcord](https://lightcord.org) is a simple and customizable client for Discord.
It includes [BandagedBD](https://github.com/rauenzi/BetterDiscordApp), [Glasstron](https://github.com/AryToNeX/Glasstron) and a [discord.js-like api](https://github.com/Lightcord/Lightcord/tree/master/DiscordJS).
2020-05-16 23:24:51 +02:00
## Information
2021-03-10 22:04:18 +01:00
Lightcord doesn't just *patch* Discord with its content. If it did, Discord updates could easily break it. That's why Lightcord is a standalone Discord client. Just grab the latest release and launch!
2020-05-16 23:24:51 +02:00
## Installing
You can download a release from the [releases tab](https://github.com/Lightcord/Lightcord/releases).
2020-05-16 23:24:51 +02:00
## Windows
You can install Lightcord with [scoop](https://github.com/lukesampson/scoop).
```powershell
scoop bucket add extras
scoop install lightcord
```
2020-07-26 13:05:33 +02:00
## AUR (Unofficial)
2020-10-18 06:11:42 +02:00
You need to install the `base-devel` and `git` packages first
2020-10-18 06:15:20 +02:00
**For compilation** https://aur.archlinux.org/packages/lightcord-git/
2020-10-18 06:17:54 +02:00
2020-10-18 06:11:42 +02:00
`git clone https://aur.archlinux.org/lightcord-git.git && cd lightcord-git && makepkg -si`
2021-03-10 22:00:18 +01:00
**For precompiled binaries** https://aur.archlinux.org/packages/lightcord-bin/
2020-10-18 06:17:54 +02:00
2020-10-18 06:11:42 +02:00
`git clone https://aur.archlinux.org/lightcord-bin.git && cd lightcord-bin && makepkg -si`
2020-11-05 18:03:21 +01:00
**For AppImage**
2020-11-05 20:47:16 +01:00
`git clone https://aur.archlinux.org/lightcord-appimage.git && cd lightcord-appimage && makepkg -si`
2020-11-05 18:03:21 +01:00
An AUR helper such as `yay` can also be used
## Other Linux Distributions
You can also install it with our *express install script*, which will automatically do the following:
- Download the latest Lightcord stable release from the official dev server.
2021-03-10 22:00:18 +01:00
- Extract the file and rename it to a more conventional ¨Lightcord¨ folder.
- Install the Lightcord files in /opt/.
- Add execution rights to the Lightcord executable to allow launching.
- Download an appropriate .desktop file and install it in /usr/share/applications.
- Add execution rights to the .desktop file to allow launching.
- Download the Lightcord icon in the .svg format and install it in /usr/share/pixmaps.
2020-10-15 17:49:59 +02:00
## Running From Source
Prerequisites: [Node.js](https://nodejs.org/en/) and NPM
To run from source, follow these instructions:
```sh
git clone https://github.com/Lightcord/Lightcord
cd Lightcord
npm run devInstall
npm test
```
*You will have to do that every time you pull/clone*
<br/>
Lightcord will then launch. If you see the Lightcord icon, you're good to go!
![icon](https://github.com/Lightcord/Lightcord/blob/master/imagery/68747470733a2f2f692e696d6775722e636f6d2f72486e73504e4f2e706e67.png?raw=true)
<br />
Any time you want to launch, just run:
```sh
npm run run
```
*You can install on GNU/Linux with our install script or the AUR*
## Express Install Script
2020-10-16 00:16:21 +02:00
- This script requires the `unzip` package to be installed. Use your package manager of choice to install it.
2021-03-19 17:04:01 +01:00
- To install, paste `sh -c "$(curl -s https://raw.githubusercontent.com/Lightcord/Lightcord/master/LULI.sh)"` in terminal and press enter. The installer will guide you through the rest.
2020-11-05 18:03:21 +01:00
## Features
* **BetterDiscord built in** - Use almost any BetterDiscord plugin or theme!
* **Easy custom rich presence** - Our method of doing this ensures you won't get banned!
2021-03-10 22:00:18 +01:00
* **Made for Privacy** - Lightcord automatically blocks Discord's trackers and blurs your email, keeping your data safe!
* **Free Emotes** - Send any emote to other Lightcord users!
* **Token Login** - (user/bot) [Make **server** calls with bots]
* **AdBlock** - Automatically block bots and ads in your DMs!
* **Always On Top** - Lightcord will always be shown in front of any other windows!
* **Experiments** - Access Discord's hidden experiments with a single click!
* **Tabs** - Have multiple tabs open to do more!
* **HypeSquad Housing** - Easily change your HypeSquad house, no test required!
* **Badges** - Important people like the developers have special badges to make sure you know who is who!
### Planned Features
* **Username History** - Keep track of your past usernames!
* **New Plugin Directory** - Easily install or edit themes and plugins!
2020-05-16 23:24:51 +02:00
## BetterDiscord
A modified version of Bandaged Better Discord comes preinstalled, making theming and adding plugins easy.
2020-05-16 23:24:51 +02:00
## Plugins & Themes
Plugins and themes are not in the standard BetterDiscord folder. They have been moved because BetterDiscord only supports the stable, PTB, and canary releases of Discord. Using the same directory could cause problems with settings.
2020-05-16 23:24:51 +02:00
2020-06-10 16:16:33 +02:00
They are located in `%AppData%/Lightcord_BD`. This is the main folder for BetterDiscord.