59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# Spee.ch
|
|
Spee.ch is a web app that reads and publishes images and videos to and from the [LBRY](https://lbry.io/) blockchain.
|
|
|
|
## How to run this repository locally
|
|
* start mysql
|
|
* install mysql
|
|
* create a database called `lbry`
|
|
* save your connection `username` and `password` someplace handy
|
|
* start lbrynet daemon
|
|
* install the [`lbry`](https://github.com/lbryio/lbry) daemon
|
|
* start the `lbry` daemon
|
|
* start spee.ch
|
|
* clone this repo
|
|
* run `npm install`
|
|
* create your `speechConfig.js` file
|
|
* copy `speechConfig.js.example` and name it `speechConfig.js`
|
|
* replace the `null` values in the config file with the appropriate values for your environment
|
|
* build the app by running `npm run build-prod`
|
|
* to start the server, run `npm run start`
|
|
* visit [localhost:3000](http://localhost:3000)
|
|
* start spee.ch-sync (optional, recommended)
|
|
* Note: this tool will decode blocks from the `lbry` blockchain and update the Claim and Certificate tables in mysql with all the claims from the blockchain. This is not necessary if you only want to host and resolve content published through your version of spee.ch, but it is required if you want to retrieve and host other content from the lbry network.
|
|
* install and run this [`speech-sync`](https://github.com/billbitt/spee.ch-sync) tool
|
|
|
|
## Tests
|
|
* Spee.ch uses `mocha` with `chai` for testing.
|
|
* To run all tests that do not require LBC, run `npm test -- --grep @usesLbc --invert`
|
|
* To run all tests, including those that require LBC (like publishing), simply run `npm test`
|
|
|
|
## API
|
|
|
|
#### GET
|
|
* /api/claim/resolve/:name/:claimId
|
|
* example: `curl https://spee.ch/api/claim/resolve/doitlive/xyz`
|
|
* /api/claim/list/:name
|
|
* example: `curl https://spee.ch/api/claim/list/doitlive`
|
|
* /api/claim/availability/:name
|
|
* returns the name if it is available
|
|
* example: `curl https://spee.ch/api/claim/availability/doitlive`
|
|
* /api/channel/availability/:name
|
|
* returns the name if it is available
|
|
* example: `curl https://spee.ch/api/channel/availability/@CoolChannel`
|
|
|
|
#### POST
|
|
* /api/claim/publish
|
|
* example: `curl -F 'name=MyPictureName' -F 'file=@/path/to/myPicture.jpeg' https://spee.ch/api/claim/publish`
|
|
* Parameters:
|
|
* `name`
|
|
* `file` (must be type .mp4, .jpeg, .jpg, .gif, or .png)
|
|
* `nsfw` (optional)
|
|
* `license` (optional)
|
|
* `title` (optional)
|
|
* `description` (optional)
|
|
* `thumbnail` url to thumbnail image, for .mp4 uploads only (optional)
|
|
* `channelName`(optional)
|
|
* `channelPassword` (optional,; required if `channelName` is provided)
|
|
|
|
## Bugs
|
|
If you find a bug or experience a problem, please report your issue here on github and find us in the lbry discord!
|