d7b9ca3391
* Upgrade to electron 17. * Remove unused dependencies. * Update recommended node version in readme. * Move all the dependencies back to devDependencies. * Move dependencies back as they were.
118 lines
7.5 KiB
Markdown
118 lines
7.5 KiB
Markdown
<img width="40%" src="https://miro.medium.com/max/5198/1*bTVuL2THG_0mpwmE-n7Ezg.png" />
|
|
|
|
# LBRY App
|
|
|
|
This repo contains the UI code that powers the official LBRY desktop app. The LBRY app is a graphical browser for the decentralized content marketplace provided by the
|
|
[LBRY](https://lbry.com) protocol. It is essentially the
|
|
[lbry daemon](https://github.com/lbryio/lbry) bundled with a UI using
|
|
[Electron](https://electron.atom.io/).
|
|
|
|
<a href="https://github.com/lbryio/lbry-desktop/blob/master/LICENSE" title="MIT licensed">
|
|
<img alt="npm" src="https://img.shields.io/dub/l/vibe-d.svg?style=flat">
|
|
</a>
|
|
<a href="https://GitHub.com/lbryio/lbry-desktop/releases/" title="GitHub release">
|
|
<img src="https://img.shields.io/github/release/lbryio/lbry-desktop.svg"/>
|
|
</a>
|
|
<a href="https://travis-ci.org/lbryio/lbry-desktop">
|
|
<img src="https://travis-ci.org/lbryio/lbry-desktop.svg?branch=master" alt="Build Status" />
|
|
</a>
|
|
<a href="https://chat.lbry.com">
|
|
<img alt="GitHub contributors" src="https://img.shields.io/discord/362322208485277697.svg?logo=discord" alt="chat on Discord">
|
|
</a>
|
|
|
|
<h2>
|
|
<a href="https://forthebadge.com" title="forthebadge">
|
|
<img alt="forthebadge" src="https://forthebadge.com/images/badges/60-percent-of-the-time-works-every-time.svg">
|
|
</a>
|
|
<a href="https://forthebadge.com" title="forthebadge">
|
|
<img alt="forthebadge" src="https://forthebadge.com/images/badges/approved-by-veridian-dynamics.svg">
|
|
</a>
|
|
</h2>
|
|
|
|
|
|
|
|
## Table of Contents
|
|
|
|
1. [Install](#install)
|
|
2. [Usage](#usage)
|
|
3. [Running from Source](#running-from-source)
|
|
4. [Contributing](#contributing)
|
|
5. [License](#license)
|
|
6. [Security](#security)
|
|
7. [Contact](#contact)
|
|
|
|
## Install
|
|
|
|
[](https://lbry.com/get/lbry.exe)
|
|
[](https://lbry.com/get/lbry.deb)
|
|
[](https://lbry.com/get/lbry.dmg)
|
|
|
|
We provide installers for Windows, macOS (v10.12.4, Sierra, or greater), and Debian-based Linux. See community maintained builds section for alternative Linux installations.
|
|
|
|
| | Windows | macOS | Linux |
|
|
| --------------------- | --------------------------------------------- | --------------------------------------------- | --------------------------------------------- |
|
|
| Latest Stable Release | [Download](https://lbry.com/get/lbry.exe) | [Download](https://lbry.com/get/lbry.dmg) | [Download](https://lbry.com/get/lbry.deb) |
|
|
| Latest Pre-release | [Download](https://lbry.com/get/lbry.pre.exe) | [Download](https://lbry.com/get/lbry.pre.dmg) | [Download](https://lbry.com/get/lbry.pre.deb) |
|
|
|
|
Our [releases page](https://github.com/lbryio/lbry-desktop/releases) also contains the latest
|
|
release, pre-releases, and past builds.
|
|
_Note: If the deb fails to install using the Ubuntu Software Center, install manually via `sudo dpkg -i <path to deb>`. You'll need to run `sudo apt-get install -f` if this is the first time installing it to install dependencies_
|
|
|
|
To install from source or make changes to the application, continue to the next section below.
|
|
|
|
**Community maintained** builds for Arch Linux and Flatpak are available, see below. These installs will need to be updated manually as the in-app update process only supports Debian installs at this time.
|
|
_Note: If coming from a deb install, the directory structure is different and you'll need to [migrate data](https://lbry.com/faq/backup-data)._
|
|
|
|
| | Flatpak | Arch | Nixpkgs | ARM/ARM64 |
|
|
| -------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------- |
|
|
| Latest Release | [FlatHub Page](https://flathub.org/apps/details/io.lbry.lbry-app) | [AUR Package](https://aur.archlinux.org/packages/lbry-app-bin/) | [Nixpkgs](https://search.nixos.org/packages?channel=unstable&show=lbry&query=lbry) | [Build Guide](https://lbry.tv/@LBRYarm:5) |
|
|
| Maintainers | [@kcSeb](https://keybase.io/kcseb) | [@kcSeb](https://keybase.io/kcseb) | [@Enderger](https://github.com/enderger) | [@Madiator2011](https://github.com/kodxana) |
|
|
|
|
## Usage
|
|
|
|
Start the installed application to interact with the LBRY network.
|
|
|
|
## Running from Source
|
|
|
|
#### Prerequisites
|
|
|
|
- [Git](https://git-scm.com/downloads)
|
|
- [Node.js](https://nodejs.org/en/download/) (v16 required)
|
|
- [Corepack](https://nodejs.org/dist/latest-v17.x/docs/api/corepack.html) `npm i -g corepack` (Included in nodejs 14 LTS, 16 LTS and 17)
|
|
- [Yarn](https://yarnpkg.com/en/docs/install)
|
|
|
|
1. Clone (or [fork](https://help.github.com/articles/fork-a-repo/)) this repository: `git clone https://github.com/lbryio/lbry-desktop`
|
|
2. Change directory into the cloned repository: `cd lbry-desktop`
|
|
3. If corepack is not enabled, run `sudo corepack enable` (the sudo is necessary for system-wide installation, if you use container, nvm etc... you might not be forced to use it)
|
|
4. Install the dependencies: `yarn`
|
|
|
|
#### Run the electron app
|
|
|
|
`yarn dev`
|
|
|
|
- If you want to build and launch the production app you can run `yarn build`. This will give you an executable inside the `/dist` folder. We use [electron-builder](https://github.com/electron-userland/electron-builder) to create distributable packages.
|
|
|
|
#### Resetting your Packages
|
|
|
|
If the app isn't building, or `yarn xxx` commands aren't working you may need to just reset your `node_modules`. To do so you can run: `rm -r node_modules && yarn` or `del /s /q node_modules && yarn` on Windows.
|
|
|
|
If you _really_ think something might have gone wrong, you can force your repo to clear everything that doesn't match the repo with `git reset --hard HEAD && git clean -fxd && git pull -r`
|
|
|
|
## Contributing
|
|
|
|
We :heart: contributions from everyone and contributions to this project are encouraged, and compensated. We welcome [bug reports](https://github.com/lbryio/lbry-desktop/issues/), [bug fixes](https://github.com/lbryio/lbry-desktop/pulls) and feedback is always appreciated. For more details, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
|
## [](https://github.com/lbryio/lbry-desktop/issues) [](https://GitHub.com/lbryio/lbry-desktop/graphs/contributors/)
|
|
|
|
## License
|
|
|
|
This project is MIT licensed. For the full license, see [LICENSE](LICENSE).
|
|
|
|
## Security
|
|
|
|
We take security seriously. Please contact security@lbry.com regarding any security issues. Our PGP key is [here](https://lbry.com/faq/pgp-key) if you need it. Previous versions up to v0.50.2 were signed by [Sean Yesmunt](https://keybase.io/seanyesmunt/key.asc).
|
|
New Releases are signed by [Jessop Breth](https://keybase.io/jessopb/key.asc).
|
|
|
|
## Contact
|
|
|
|
The primary contact for this project is [@jessopb](https://github.com/jessopb).
|