2016-05-23 04:45:08 +02:00
[](https://travis-ci.org/lbryio/lbry)
2016-10-30 22:55:12 +01:00
[](https://coveralls.io/github/lbryio/lbry)
2016-05-23 04:45:08 +02:00
2017-01-10 00:01:50 +01:00
# LBRY
2015-08-20 17:27:15 +02:00
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.
2017-01-10 00:01:50 +01:00
2017-03-13 16:59:12 +01:00
This repo is a reference implementation of the [LBRY API ](https://lbry.io/api ).
2017-01-10 00:01:50 +01:00
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.
2017-02-20 22:12:47 +01:00
2017-03-13 16:59:12 +01:00
## Installing
2015-08-20 17:27:15 +02:00
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 ).
2017-02-20 22:12:47 +01:00
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.
2017-02-20 22:12:47 +01:00
2017-03-13 16:59:12 +01:00
Installing from source is also relatively painless, full instructions are in [INSTALL.md ](INSTALL.md )
2017-02-20 22:12:47 +01:00
2017-03-13 17:05:13 +01:00
## Running
2016-05-23 22:13:46 +02:00
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 ).
2016-05-23 22:13:46 +02:00
2017-01-10 00:01:50 +01:00
## What is LBRY?
LBRY is a fully decentralized network for distributing data. It 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.
2015-08-20 17:27:15 +02:00
2017-02-20 22:12:47 +01:00
On LBRY, data is broken into chunks, and each chunk is content
addressable, specified by its sha384 hash sum. This guarantees that
peers can verify the correctness of each chunk without having to know
anything about its contents, and can confidently re-transmit the chunk
to other peers. Peers wishing to transmit chunks to other peers
announce to the distributed hash table that they are associated with
the sha384 hash sum in question. When a peer wants to download that
chunk from the network, it asks the distributed hash table which peers
are associated with that sha384 hash sum. The distributed hash table
can also be used more generally. It simply stores IP addresses and
ports which are associated with 384-bit numbers, and can be used by
any type of application to help peers find each other. For example, an
application for which clients don't know all of the necessary chunks
may use some identifier, chosen by the application, to find clients
which do know all of the necessary chunks.
## Contributions
2015-08-20 17:27:15 +02:00
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.
2015-08-20 17:27:15 +02:00
2015-09-11 21:06:28 +02:00
## Support
2015-08-20 17:27:15 +02:00
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.
2017-01-10 00:01:50 +01:00
For private issues, contact jeremy@lbry.io.
2015-08-20 17:27:15 +02:00
2015-09-11 21:06:28 +02:00
## License
2015-08-20 17:27:15 +02:00
2015-12-06 20:36:41 +01:00
See [LICENSE ](LICENSE )
