A browser and wallet for LBRY, the decentralized, user-controlled content marketplace.
Find a file
2020-11-09 13:37:51 -05:00
.github Delete first timers issue template 2020-08-05 11:03:43 -04:00
.tx make "I Understand" acknowledgement work for i18n case 2019-10-13 12:42:55 -04:00
build Sign In => Log in 2020-09-29 17:12:32 -04:00
custom large claim-grid header text + optional icon 2020-09-29 17:12:32 -04:00
electron openItem is now openPath 2020-10-12 09:50:56 -04:00
flow-typed per channel notification settings 2020-11-02 14:13:13 -05:00
static Localize the "analytics down" message. 2020-11-09 10:44:45 -05:00
ui fix floating player location on desktop 2020-11-09 13:37:51 -05:00
web send auth token with status call 2020-10-28 16:04:12 -04:00
.env.defaults creator only like reactions 2020-10-27 12:27:30 -04:00
.eslintrc.json bring in comment code from lbry-redux 2020-06-23 16:01:20 -04:00
.flowconfig per channel notification settings 2020-11-02 14:13:13 -05:00
.gitignore sample robots files 2020-09-29 12:10:30 -04:00
.lintstagedrc.json rename lbrytv to web 2020-05-25 17:21:02 -04:00
.prettierrc.json redesign channel page 2019-05-06 23:29:50 -04:00
.sentryclirc update sentry config 2020-02-14 16:42:02 -05:00
.travis.yml add SHARE_DOMAIN_URL to travis config 2020-09-11 01:57:59 -04:00
action.yml update changelog and add back dangerfile 2019-09-03 23:21:24 -04:00
babel.config.js use same code for handling open links on lbry.tv and desktop 2019-12-03 13:25:17 -05:00
CHANGELOG.md update changelog 2020-11-02 17:27:08 -05:00
config.js creator only like reactions 2020-10-27 12:27:30 -04:00
CONTRIBUTING.md Updated the broken link 2020-05-11 09:30:30 -04:00
dangerfile.js update changelog and add back dangerfile 2019-09-03 23:21:24 -04:00
Dockerfile remove old keytar references 2020-03-24 10:20:29 -04:00
electron-builder.json Initial commit for LBRY-First 2020-07-08 14:23:43 -04:00
LICENSE Update LICENSE 2020-02-03 09:19:48 -05:00
package.json bump lbry-redux 2020-11-09 13:37:51 -05:00
postcss.config.js redesign channel page 2019-05-06 23:29:50 -04:00
README.md Changed Raspberry Pi to ARM 2020-08-18 22:57:03 -04:00
webpack.base.config.js integrate PostCSS-plugin for RTL-adaptivity 2020-07-29 17:54:10 -04:00
webpack.electron.config.js Initial commit for LBRY-First 2020-07-08 14:23:43 -04:00
yarn.lock bump lbry-redux 2020-11-09 13:37:51 -05:00

LBRY App - https://lbry.tv

This repo contains the UI code that powers the official LBRY desktop app, as well as lbry.tv. 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.

npm Build Status GitHub contributors

forthebadge forthebadge

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.

Windows macOS Linux
Latest Stable Release Download Download Download
Latest Pre-release Download Download Download

Our releases page 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.

Flatpak Arch ARM/ARM64
Latest Release FlatHub Page AUR Package Build Guide
Maintainers @kcSeb @kcSeb/@TimurKiyivinski @Madiator2011

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/lbryio/lbry-desktop
  2. Change directory into the cloned repository: cd lbry-desktop
  3. Install the dependencies: yarn

Run the electron app

yarn compile:electron (this is only needed the first time you run the 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.

Run the web app for development

yarn compile:web (this is only needed the first time you run the app)

yarn dev:web

  • This uses webpack-dev-server and includes hot-reloading. If you want to debug the web server we use in production you can run yarn dev:web-server. This starts a server at localhost:1337 and does not include hot reloading.

Customize the web app

  • In root directory, copy .env.defaults to .env and make changes
cp .env.defaults .env
nano .env
  • To specify your own OG-IMAGE You can either place a png named v2-og.png in the /custom folder or specify the OG_IMAGE_URL in .env

  • To specify your own channels to be followed on first run AUTO_FOLLOW_URLS=lbry://@chan#123...a lbry://@chan2#456...a

  • If you want to customize the homepage content

  1. add CUSTOM_HOMEPAGE=true to the '.env' file
  2. copy /custom/homepage.example.js to /custom/homepage.js and make desired changes to homepage.js
  • If you want up to two custom sidebar links
PINNED_URI_1=@someurl#2/someclaim#4
PINNED_LABEL_1=Linktext

PINNED_URI_2=$/discover?t=tag&[queryparams]
PINNED_LABEL_2=OtherLinkText
  • Finally NODE_ENV=production yarn compile:web to rebuild Note: You don't need to edit the .env file in the /web folder - that is copied during compile.

Deploy the web app (experimental)

  1. Create a server with a domain name and a reverse proxy https to port 1337.
  2. Install pm2, node v10, yarn
  3. Clone this repo
  4. Make any customizations as above
  5. Run yarn to install
  6. Run NODE_ENV=production yarn compile:web to build
  7. Set up pm2 to start ./web/index.js

Run both at the same time

Run the two commands above in separate terminal windows

yarn dev

// in another terminal window
yarn dev:web

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. All releases are signed by Sean Yesmunt.

Contact

The primary contact for this project is @seanyesmunt.