btorrent/README.md

88 lines
2.7 KiB
Markdown
Raw Normal View History

2015-11-30 20:09:37 +00:00
βTorrent
========
**[βTorrent]** is a fully-featured **[WebTorrent]** browser client written in [Jade], [CoffeeScript] and [Sass]
### Features
- [x] Informative GUI with easy sharing options
- [x] Downloading from an info hash or magnet URI
2015-12-07 16:53:57 +00:00
- [x] Downloading from a .torrent file (Coming Soon)
- [x] Seeding files (Single/multiple files)
- [ ] Seeding CORS-enabled remote files (Coming Soon)
- [x] Download/Upload speed per torrent
2015-12-17 19:15:10 +00:00
- [x] Download/Upload speed of client (All torrents)
- [x] Removing torrents from the client
- [x] Pause/Resume torrent
- [x] Selecting/Deselecting files (Coming Soon)
- [x] Client Debugging
2015-12-08 16:42:32 +00:00
- [ ] Use custom trackers/rtcConfig
2015-11-30 20:09:37 +00:00
### Built with
- [WebTorrent]
- [AngularJS]
- [Skeleton]
- [Normalize.css]
- [Moment.js]
- [ui-grid]
2015-11-30 20:09:37 +00:00
- [pretty-bytes]
- [ng-file-upload]
2015-12-08 16:36:41 +00:00
- [ng-notify]
2015-11-30 20:09:37 +00:00
Website powered by [jsDelivr] and [CloudFlare]. I use [nginx] in my server.
Don't like CloudFlare? No problem! Check [Direct-βTorrent].
2015-11-30 20:09:37 +00:00
### Easily built, tested and served
2015-12-01 15:34:56 +00:00
**I use [Harp] to rapidly test and compile the project**
2015-11-30 20:09:37 +00:00
2015-12-01 15:34:56 +00:00
Build the project into HTML, JS and CSS easily. Just use:
2015-11-30 20:09:37 +00:00
```bash
harp compile
```
This will create a www folder with the compiled files
If you need to serve the files and view the compiled version instantly just use:
```bash
harp server
```
### Enable Debugging
Enable βTorrent (Debug logging) and WebTorrent (Logs logging) debug logs by running this in the developer console:
2015-11-30 20:09:37 +00:00
```js
localStorage.debug = '*'
2015-11-30 20:09:37 +00:00
```
Disable by running this:
2015-11-30 20:09:37 +00:00
```js
localStorage.removeItem('debug')
2015-11-30 20:09:37 +00:00
```
### Help βTorrent
2015-11-30 20:20:57 +00:00
- **[Create a new issue](https://github.com/DiegoRBaquero/bTorrent/issues/new)** to report bugs or suggest new features
2015-12-01 15:41:34 +00:00
- **[Send a PR](https://github.com/DiegoRBaquero/BTorrent/pull/new/master)** with your changes
2015-11-30 20:09:37 +00:00
### Thanks
- [jasalo](https://github.com/jasalo) For the logo and favicon
- [whitef0x0](https://github.com/whitef0x0) For cleanup and ng-file-upload and other ideas
2015-11-30 20:09:37 +00:00
### License
MIT. Copyright (c) [Diego Rodríguez Baquero](http://diegorbaquero.com)
[βTorrent]: https://btorrent.xyz
[Direct-βTorrent]: https://direct.btorrent.xyz
2015-11-30 20:09:37 +00:00
[WebTorrent]: https://webtorrent.io
[AngularJS]: https://angularjs.org/
[Skeleton]: http://getskeleton.com/
[Normalize.css]: https://necolas.github.io/normalize.css/
[Moment.js]: http://momentjs.com/
[ui-grid]: http://ui-grid.info/
2015-11-30 20:09:37 +00:00
[pretty-bytes]: https://github.com/sindresorhus/pretty-bytes
[ng-file-upload]: https://github.com/danialfarid/ng-file-upload
2015-12-08 16:36:41 +00:00
[ng-notify]: https://github.com/matowens/ng-notify
2015-11-30 20:09:37 +00:00
[Jade]: http://jade-lang.com/
[CoffeeScript]: http://coffeescript.org/
[Sass]: http://sass-lang.com/
[Harp]: http://harpjs.com/
[jsDelivr]: https://www.jsdelivr.com/
[CloudFlare]: https://www.cloudflare.com/
[nginx]: http://nginx.org/