2017-02-20 14:50:06 -06:00
# LBRY App
2017-01-16 14:06:53 -05:00
2017-03-09 12:31:07 -05:00
This is a graphical browser for the decentralized content marketplace provided by the [LBRY ](https://lbry.io ) protocol. It is essentially the [lbry daemon ](https://github.com/lbryio/lbry ) bundled with a UI using [Electron ](http://electron.atom.io/ ).
2017-01-16 14:06:53 -05:00
2017-02-21 13:10:20 -05:00
## Installing
2017-01-18 10:32:01 -06:00
2017-03-13 11:37:49 -04:00
We provide installers for Windows, macOS, and Debian-based Linux.
| Windows | macOS | Linux |
| --- | --- | --- |
2017-03-28 12:05:17 -04:00
| [Download ](https://lbry.io/get/lbry.exe ) | [Download ](https://lbry.io/get/lbry.dmg ) | [Download ](https://lbry.io/get/lbry.deb ) |
2017-03-13 11:37:49 -04:00
Our [releases page ](https://github.com/lbryio/lbry-app/releases/latest ) also contains the latest release, pre-releases, and past builds.
2017-01-16 14:06:53 -05:00
2017-02-21 13:10:20 -05:00
To install from source or make changes to the application, continue reading below.
2017-01-16 14:06:53 -05:00
2017-02-21 13:10:20 -05:00
## Development
2017-01-16 14:06:53 -05:00
2017-02-21 13:10:20 -05:00
This repo uses submodules, so clone it using `--recursive` .
2017-01-16 14:06:53 -05:00
2017-02-20 14:50:06 -06:00
### Setup
2017-01-16 14:06:53 -05:00
2017-02-20 14:50:06 -06:00
The
2017-02-21 13:10:20 -05:00
[lbry daemon ](https://github.com/lbryio/lbry/blob/master/INSTALL.md ) needs
2017-02-20 14:50:06 -06:00
to be installed along with pyinstaller. You also need to be
able to build the lbry-web-ui, so have node, webpack, etc installed.
2017-01-16 14:06:53 -05:00
2017-02-20 14:50:06 -06:00
### Build
2017-01-16 14:06:53 -05:00
2017-02-20 14:50:06 -06:00
run `./build.sh`
2017-01-16 14:06:53 -05:00
2017-02-20 14:50:06 -06:00
This builds the UI assets and puts them into `app/dist` . It also builds `app/dist/lbrynet-daemon` .
### Run
`./node_modules/.bin/electron app`
2017-01-16 14:06:53 -05:00
2017-02-20 14:50:06 -06:00
### Package
2017-01-16 14:06:53 -05:00
2017-02-20 14:50:06 -06:00
We use [electron-builder ](https://github.com/electron-userland/electron-builder )
to create distributable packages, which is run by calling:
2017-01-16 14:06:53 -05:00
2017-02-20 14:50:06 -06:00
`node_modules/.bin/build -p never`
2017-02-21 13:10:20 -05:00
### Development on Windows
This project has currently only been worked on in Linux and macOS. If you are on Windows, you can
2017-04-22 15:21:04 +01:00
checkout out the build steps in [appveyor.yml ](https://github.com/lbryio/lbry-app/blob/master/.appveyor.yml ) and probably figure out something from there.
