lbry-desktop/README.md

78 lines
3.5 KiB
Markdown
Raw Normal View History

2017-02-20 21:50:06 +01:00
# LBRY App
2017-01-16 20:06:53 +01:00
2017-03-09 18:31:07 +01: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 20:06:53 +01:00
2017-06-02 00:24:20 +02:00
![App Screenshot](https://lbry.io/img/lbry-ui.png)
2017-02-21 19:10:20 +01:00
## Installing
2017-01-18 17:32:01 +01:00
We provide installers for Windows, macOS, and Debian-based Linux.
2017-05-19 16:30:13 +02:00
| | Windows | macOS | Linux |
| --- | --- | --- | --- |
| Latest Stable Release | [Download](https://lbry.io/get/lbry.exe) | [Download](https://lbry.io/get/lbry.dmg) | [Download](https://lbry.io/get/lbry.deb) |
| Latest Prerelease | [Download](https://lbry.io/get/lbry.pre.exe) | [Download](https://lbry.io/get/lbry.pre.dmg) | [Download](https://lbry.io/get/lbry.pre.deb) |
Our [releases page](https://github.com/lbryio/lbry-app/releases/latest) also contains the latest release, pre-releases, and past builds.
2017-01-16 20:06:53 +01:00
2017-02-21 19:10:20 +01:00
To install from source or make changes to the application, continue reading below.
2017-01-16 20:06:53 +01:00
## Development on Linux and macOS
2017-01-16 20:06:53 +01:00
2017-06-02 00:20:29 +02:00
### One-time Setup
2017-01-16 20:06:53 +01:00
1. Clone this repo
2017-11-10 16:47:51 +01:00
2. `DEPS=true ./build.sh`
2017-11-10 17:49:22 +01:00
This will download and install the LBRY app and its dependencies, including [the LBRY daemon](https://github.com/lbryio/lbry) and command line utilities like `node` and `yarn`. The LBRY app requires Node >= 6; if you have an earlier version of Node installed and want to keep it, you can use [nvm](https://github.com/creationix/nvm) to switch back and forth.
2017-01-16 20:06:53 +01:00
2017-06-02 00:20:29 +02:00
### Ongoing Development
2017-12-07 16:40:49 +01:00
Run `yarn dev`
2017-02-20 21:50:06 +01:00
2017-12-07 21:04:34 +01:00
This will set up a server that will automatically compile any changes made inside `src\` folder and automatically reload the app without losing the state.
2017-01-16 20:06:53 +01:00
2017-06-02 00:20:29 +02:00
### Packaging
2017-01-16 20:06:53 +01:00
2017-12-07 16:40:49 +01:00
Run `yarn dist`
2017-01-16 20:06:53 +01:00
2017-12-07 16:40:49 +01:00
We use [electron-builder](https://github.com/electron-userland/electron-builder)
to create distributable packages.
2017-02-21 19:10:20 +01:00
## Development on Windows
2017-02-21 19:10:20 +01:00
### Windows Dependency
1. Download and install `git` from <a href="https://git-for-windows.github.io/">github.io<a> (configure to use command prompt integration)
2. Download and install `npm` and `node` from <a href="https://nodejs.org/en/download/current/">nodejs.org<a>
3. Download and install `python 2.7` from <a href="https://www.python.org/downloads/windows/">python.org</a>
4. Download and Install `Microsoft Visual C++ Compiler for Python 2.7` from <a href="https://www.microsoft.com/en-us/download/confirmation.aspx?id=44266">Microsoft<a>
5. Download and install `.NET Framework 2.0 Software Development Kit (SDK) (x64)` from <a href="https://www.microsoft.com/en-gb/download/details.aspx?id=15354">Microsoft<a> (may need to extract setup.exe and install manually by running install.exe as Administrator)
### One-time Setup
1. Open command prompt as adminstrator and run the following:
```
npm install --global --production windows-build-tools
exit
```
2. Open command prompt in the root of the project and run the following:
```
python -m pip install -r build\requirements.txt
npm install -g yarn
yarn install
2017-12-07 16:40:49 +01:00
yarn dist
```
3. Download the lbry daemon and cli [binaries](https://github.com/lbryio/lbry/releases) and place them in `dist\`
### Building lbry-app
2017-12-07 16:40:49 +01:00
Run `yarn dist`
### Ongoing Development
2017-12-07 16:40:49 +01:00
Run `yarn dev`
2017-12-07 21:04:34 +01:00
This will set up a server that will automatically compile any changes made inside `src\` folder and automatically reload the app without losing the state.
2017-05-31 12:59:58 +02:00
## Internationalization
2017-12-07 16:40:49 +01:00
If you want to help translating the lbry-app, you can copy the `en.json` file in `/dist/locales/` and modify the values while leaving the keys as their original English strings. An example for this would be: `"Skip": "Überspringen",` Translations should automatically show up in options.