/lbry-desktop

LBRY Desktop Community Edition (CE)

Primary LanguageJavaScriptMIT LicenseMIT

LBRY App - Community Edition

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 protocol. It is essentially the lbry daemon bundled with a UI using Electron.

Community Edition

This is the Community Edition (CE) of the LBRY desktop app. This LBRY CE version includes additional improvements and changes, including but not limited by:

  • Adding Rewards feature back;
  • Disable Matomo Analytics, meaning no telemetry / tracking;
  • Adding Referral feature back;
  • Adding Sync YouTube Channel menu item back;
  • Enable file reactions
  • Enable creator reactions
  • Enable no source claims

The LBRY Community Edition binaries are licensed under the MIT license. With additional features. Telemetry is disabled.

npm Build Status GitHub contributors

App GIF

Table of Contents

  1. Install
  2. Usage
  3. Running from Source
  4. Contributing
  5. License
  6. Security
  7. Contact

Install

Windows Linux MacOS

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.

Download Community Edition from:

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.

TODO

Usage

Double click the installed application to interact with the LBRY network.

Running from Source

You can run the web version (lbry.tv), the electron app, or both at the same time.

Prerequisites

  1. Clone (or fork) this repository: git clone https://github.com/lbry-foss/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 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 ❤️ contributions from everyone and contributions to this project are encouraged, and compensated. We welcome bug reports, bug fixes and feedback is always appreciated. For more details, see CONTRIBUTING.md.

contributions welcome GitHub contributors

License

This project is MIT licensed. For the full license, see LICENSE.

Security

We take security seriously. Please contact security@lbry.com regarding any security issues. Our PGP key is here if you need it. Previous versions up to v0.50.2 were signed by Sean Yesmunt. New Releases are signed by Jessop Breth.

Contact

The primary contact for this project is @danger89.