lbry-sdk/README.md

[![Build Status](https://travis-ci.org/lbryio/lbry.svg?branch=master)](https://travis-ci.org/lbryio/lbry)
[![Coverage Status](https://coveralls.io/repos/github/lbryio/lbry/badge.svg)](https://coveralls.io/github/lbryio/lbry)

# LBRY

LBRY is an open-source protocol providing distribution, discovery, and purchase of digital content (data) via a decentralized network.

This repo is a reference implementation of the [LBRY API](https://lbry.io/api). 

It provides a daemon that can interact with the network via a json-rpc interface over HTTP.

## Installing

**Note**: This project no longer directly bundles a graphic interface (browser). If you want to use LBRY via a browser, [use the LBRY App](https://github.com/lbryio/lbry-app).

Our [releases page](https://github.com/lbryio/lbry-app/releases/latest) contains pre-built binaries of the latest release, pre-releases, and past releases, for macOS, Debian-based Linux, and Windows.

Installing from source is also relatively painless, full instructions are in [INSTALL.md](INSTALL.md)

## Running

Run `lbrynet-daemon` to launch the daemon.

## Using

By default, `lbrynet-daemon` will provide a JSON-RPC server at `http://localhost:5279`. It is easy to interact with via cURL or sane programming languages.

Our [quickstart guide](http://lbry.io/quickstart) provides clear sample usages and free credits for learning.

The full API is documented [here](https://lbry.io/api).

## What is LBRY?

LBRY is a protocol providing fully decentralized network for the discovery, distribution, and payment of data. 

It utilizes the [LBRY blockchain](https://github.com/lbryio/lbrycrd) as a global namespace and database of digital content. Blockchain entries contain searchable content metadata, identities, and rights and access rules.

LBRY also provides a data network consists of peers uploading and downloading data from other peers, possibly in exchange for payments, and a distributed hash table, used by peers to discover other peers.

## Contributions

To contribute, [join us on Slack](https://slack.lbry.io/) or contact jeremy@lbry.io. Pull requests are also welcome.

## Support

Please open an issue and describe your situation in detail. We will respond as soon as we can.

For private issues, contact jeremy@lbry.io.

## License

See [LICENSE](LICENSE)
:shipit: travis build badge :shipit: 2016-05-23 04:45:08 +02:00			`[![Build Status](https://travis-ci.org/lbryio/lbry.svg?branch=master)](https://travis-ci.org/lbryio/lbry)`
Add coveralls badge 2016-10-30 22:55:12 +01:00			`[![Coverage Status](https://coveralls.io/repos/github/lbryio/lbry/badge.svg)](https://coveralls.io/github/lbryio/lbry)`
:shipit: travis build badge :shipit: 2016-05-23 04:45:08 +02:00
improvements to readme and install instructions (#396) * improvements to readme and install instructions * Update README.md * Update INSTALL.md 2017-01-10 00:01:50 +01:00			`# LBRY`
initial commit 2015-08-20 17:27:15 +02:00
update readme to reflect new packaging 2017-03-13 16:59:12 +01:00			`LBRY is an open-source protocol providing distribution, discovery, and purchase of digital content (data) via a decentralized network.`
improvements to readme and install instructions (#396) * improvements to readme and install instructions * Update README.md * Update INSTALL.md 2017-01-10 00:01:50 +01:00
update readme to reflect new packaging 2017-03-13 16:59:12 +01:00			`This repo is a reference implementation of the [LBRY API](https://lbry.io/api).`
improvements to readme and install instructions (#396) * improvements to readme and install instructions * Update README.md * Update INSTALL.md 2017-01-10 00:01:50 +01:00
update readme to reflect new packaging 2017-03-13 16:59:12 +01:00			`It provides a daemon that can interact with the network via a json-rpc interface over HTTP.`
update readme 2017-02-20 22:12:47 +01:00
update readme to reflect new packaging 2017-03-13 16:59:12 +01:00			`## Installing`
initial commit 2015-08-20 17:27:15 +02:00
update readme to reflect new packaging 2017-03-13 16:59:12 +01:00			`Note: This project no longer directly bundles a graphic interface (browser). If you want to use LBRY via a browser, [use the LBRY App](https://github.com/lbryio/lbry-app).`
update readme 2017-02-20 22:12:47 +01:00
update readme to reflect new packaging 2017-03-13 16:59:12 +01:00			`Our [releases page](https://github.com/lbryio/lbry-app/releases/latest) contains pre-built binaries of the latest release, pre-releases, and past releases, for macOS, Debian-based Linux, and Windows.`
update readme 2017-02-20 22:12:47 +01:00
update readme to reflect new packaging 2017-03-13 16:59:12 +01:00			`Installing from source is also relatively painless, full instructions are in [INSTALL.md](INSTALL.md)`
update readme 2017-02-20 22:12:47 +01:00
running and usage 2017-03-13 17:05:13 +01:00			`## Running`
readme rewrite 2016-05-23 22:13:46 +02:00
running and usage 2017-03-13 17:05:13 +01:00			Run `lbrynet-daemon` to launch the daemon.

			`## Using`

			By default, `lbrynet-daemon` will provide a JSON-RPC server at `http://localhost:5279`. It is easy to interact with via cURL or sane programming languages.

			`Our [quickstart guide](http://lbry.io/quickstart) provides clear sample usages and free credits for learning.`

			`The full API is documented [here](https://lbry.io/api).`
readme rewrite 2016-05-23 22:13:46 +02:00
improvements to readme and install instructions (#396) * improvements to readme and install instructions * Update README.md * Update INSTALL.md 2017-01-10 00:01:50 +01:00			`## What is LBRY?`

more readme cleanup 2017-03-13 17:14:02 +01:00			`LBRY is a protocol providing fully decentralized network for the discovery, distribution, and payment of data.`

			`It utilizes the [LBRY blockchain](https://github.com/lbryio/lbrycrd) as a global namespace and database of digital content. Blockchain entries contain searchable content metadata, identities, and rights and access rules.`

			`LBRY also provides a data network consists of peers uploading and downloading data from other peers, possibly in exchange for payments, and a distributed hash table, used by peers to discover other peers.`
update readme 2017-02-20 22:12:47 +01:00
			`## Contributions`
initial commit 2015-08-20 17:27:15 +02:00
update readme to reflect new packaging 2017-03-13 16:59:12 +01:00			`To contribute, [join us on Slack](https://slack.lbry.io/) or contact jeremy@lbry.io. Pull requests are also welcome.`
initial commit 2015-08-20 17:27:15 +02:00
github doesn't like setext markdown headers 2015-09-11 21:06:28 +02:00			`## Support`
initial commit 2015-08-20 17:27:15 +02:00
readme rewrite 2016-05-23 22:13:46 +02:00			`Please open an issue and describe your situation in detail. We will respond as soon as we can.`

improvements to readme and install instructions (#396) * improvements to readme and install instructions * Update README.md * Update INSTALL.md 2017-01-10 00:01:50 +01:00			`For private issues, contact jeremy@lbry.io.`
initial commit 2015-08-20 17:27:15 +02:00
github doesn't like setext markdown headers 2015-09-11 21:06:28 +02:00			`## License`
initial commit 2015-08-20 17:27:15 +02:00
Fix LICENSE link I broke it, oops. 2015-12-06 20:36:41 +01:00			`See [LICENSE](LICENSE)`