tstor/README.md

82 lines
4.1 KiB
Markdown
Raw Normal View History

2021-04-04 17:24:58 +00:00
[![Releases][releases-shield]][releases-url]
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![GPL3 License][license-shield]][license-url]
[![Coveralls][coveralls-shield]][coveralls-url]
2021-04-04 17:24:58 +00:00
[![Docker Image][docker-pulls-shield]][docker-pulls-url]
<!-- PROJECT LOGO -->
<br />
<p align="center">
<a href="https://github.com/distribyted/distribyted">
<img src="mkdocs/docs/images/distribyted_icon.png" alt="Logo" width="100">
</a>
<h3 align="center">distribyted</h3>
<p align="center">
Torrent client with on-demand file downloading as a filesystem.
<br />
<br />
<a href="https://github.com/distribyted/distribyted/issues">Report a Bug</a>
·
<a href="https://github.com/distribyted/distribyted/issues">Request Feature</a>
</p>
</p>
## About The Project
![Distribyted Screen Shot][product-screenshot]
2021-10-08 09:52:37 +00:00
Distribyted is an alternative torrent client.
It can expose torrent files as a standard FUSE mount or webDAV endpoint and download them on demand, allowing random reads using a fixed amount of disk space.
2021-10-08 09:52:37 +00:00
Distribyted tries to make easier integrations with other applications using torrent files, presenting them as a standard filesystem.
**Note that distribyted is in alpha version, it is a proof of concept with a lot of bugs.**
2021-10-08 09:52:37 +00:00
## Use Cases
- Play **multimedia files** on your favorite video or audio player. These files will be downloaded on demand and only the needed parts.
- Explore TBs of data from public **datasets** only downloading the parts you need. Use **Jupyter Notebooks** directly to process or analyze this data.
- Play your **ROM backups** directly from the torrent file. You can have virtually GBs in games and only downloaded the needed ones.
2021-10-08 09:52:37 +00:00
## Documentation
Check [here][main-url] or [here][doc-folder-url] for further documentation.
2021-10-08 09:52:37 +00:00
## Contributing
2021-10-08 09:52:37 +00:00
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
2021-11-18 19:36:07 +00:00
Any contribution is welcome, but some areas need more care than others:
- Windows and macOS tests and compatibility. I don't have any easy way to test distribyted on these operating systems.
- Web interface. Web development is not my _forte_.
2021-10-08 09:52:37 +00:00
## License
2021-10-08 09:52:37 +00:00
Distributed under the GPL3 license. See `LICENSE` for more information.
2021-10-07 18:21:56 +00:00
[doc-folder-url]: https://github.com/distribyted/distribyted/blob/master/mkdocs/docs/index.md
[main-url]: https://distribyted.com
2021-04-04 17:24:58 +00:00
[releases-shield]: https://img.shields.io/github/v/release/distribyted/distribyted.svg?style=flat-square
[releases-url]: https://github.com/distribyted/distribyted/releases
[docker-pulls-shield]:https://img.shields.io/docker/pulls/distribyted/distribyted.svg?style=flat-square
[docker-pulls-url]:https://hub.docker.com/r/distribyted/distribyted
[contributors-shield]: https://img.shields.io/github/contributors/distribyted/distribyted.svg?style=flat-square
[contributors-url]: https://github.com/distribyted/distribyted/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/distribyted/distribyted.svg?style=flat-square
[forks-url]: https://github.com/distribyted/distribyted/network/members
[stars-shield]: https://img.shields.io/github/stars/distribyted/distribyted.svg?style=flat-square
[stars-url]: https://github.com/distribyted/distribyted/stargazers
[issues-shield]: https://img.shields.io/github/issues/distribyted/distribyted.svg?style=flat-square
[issues-url]: https://github.com/distribyted/distribyted/issues
[releases-url]: https://github.com/distribyted/distribyted/releases
[license-shield]: https://img.shields.io/github/license/distribyted/distribyted.svg?style=flat-square
[license-url]: https://github.com/distribyted/distribyted/blob/master/LICENSE
[product-screenshot]: mkdocs/docs/images/distribyted.gif
2020-08-03 17:44:08 +00:00
[example-config]: https://github.com/distribyted/distribyted/blob/master/examples/conf_example.yaml
[coveralls-shield]: https://img.shields.io/coveralls/github/distribyted/distribyted?style=flat-square
[coveralls-url]: https://coveralls.io/github/distribyted/distribyted