mirror of
https://github.com/VueTorrent/VueTorrent.git
synced 2024-11-25 10:55:50 +03:00
114 lines
4.3 KiB
Markdown
114 lines
4.3 KiB
Markdown
<div>
|
|
<img align="left" width="200" src="https://cdn.jsdelivr.net/gh/WDaan/VueTorrent/VueTorrent-logo.png" alt="VueTorrent"/>
|
|
<h1>VueTorrent</h1>
|
|
<p>The sleekest looking WebUI for qBittorrent made with Vue.js!</p>
|
|
</div>
|
|
|
|
 
|
|
|
|
|
|
 
|
|
 
|
|
 
|
|
 
|
|
|
|
## Screenshots
|
|
|
|
- Desktop
|
|
<p align="middle">
|
|
<img src="readme_assets/screenshot-desktop.png" width="800" />
|
|
</p>
|
|
|
|
- Desktop Dark Mode
|
|
<p align="middle">
|
|
<img src="readme_assets/screenshot-desktop-dark-mode.png" width="800" />
|
|
</p>
|
|
|
|
- Mobile
|
|
<p align="middle">
|
|
<img src="readme_assets/screenshot-mobile.png" width="400" />
|
|
<img src="readme_assets/screenshot-mobile-navbar.png" width="400" />
|
|
</p>
|
|
|
|
- Mobile Dark Mode
|
|
<p align="middle">
|
|
<img src="readme_assets/screenshot-mobile-dark-mode.png" width="400" />
|
|
<img src="readme_assets/screenshot-mobile-navbar-dark-mode.png" width="400" />
|
|
</p>
|
|
|
|
## Installation
|
|
|
|
### Manual
|
|
|
|
- Visit the [Releases](https://github.com/WDaan/VueTorrent/releases) page!
|
|
- Download the latest `vuetorrent.zip`
|
|
- Unzip the downloaded file
|
|
- Point your alternate WebUI location to the `vuetorrent` folder in qBittorrent settings
|
|
|
|
### From Source
|
|
|
|
- Clone branch using
|
|
- `git clone --single-branch --branch latest-release https://github.com/WDaan/VueTorrent.git`
|
|
- Pull changes every once in a while, using `git pull`
|
|
|
|
If you like to always have the latest and greatest, please sync to the `nightly-release`-branch. This can contain breaking changes though.
|
|
|
|
### Lazy/Easy
|
|
|
|
- use [hotio's qbittorrent](https://hotio.dev/containers/qbittorrent/) docker image, that comes pre-packed with VueTorrent.
|
|
|
|
[Alternative methods - May work for older QBit versions](../../wiki/Alternative_Installation_Methods)
|
|
|
|
## Development
|
|
|
|
- Clone the repo
|
|
- `npm install`
|
|
- `npm start`
|
|
- `npm run lint` (to format the code)
|
|
- `docker-compose up -d` (starts a qbittorrent docker, optional)
|
|
- Open the WebUI on localhost with the default username `admin` and password `adminadmin`.
|
|
- Make sure CSRF protection is disabled on the target server!
|
|
- Edit `env.development` to tweak your dev environment (e.g. fake torrents)
|
|
|
|
## Features
|
|
|
|
- Torrents
|
|
- add / remove / pause / resume / rename torrents
|
|
- selectively download files
|
|
- view info / trackers / peers / content / tags & categories
|
|
- search for new torrents straight from the WebUI!
|
|
- search filtering powered by Fuse.js!
|
|
- Keyboard shortcuts!
|
|
- select all torrents with <kbd>Ctrl</kbd>-<kbd>A</kbd>
|
|
- delete selected torrents with <kbd>delete</kbd>
|
|
- <kbd>Shift</kbd>-click to select from one torrent
|
|
- System
|
|
- see session stats (down / upload speed, session uploaded / downloaded, free space)
|
|
- beautiful transfer graphs
|
|
- change the most common settings
|
|
- Extra features the default WebUI doesn't have
|
|
- mobile friendly! (can be installed as a PWA)
|
|
- Configureable Dashboard: choose which torrent properties are shown for both busy and completed torrents
|
|
- works with qBittorrent v4.4 and later
|
|
|
|
## Contributing
|
|
|
|
I'll gladly accept help/pull requests & advice!
|
|
|
|
[FAQ](../../wiki/FAQ)
|
|
|
|
## Support
|
|
|
|
Open up an issue 😛
|
|
|
|
but before you do that:
|
|
|
|
- confirm you're on the latest version of VueTorrent
|
|
- confirm there is no other issue mentioning the same problem
|
|
|
|
<a href="https://www.buymeacoffee.com/wdaan"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=wdaan&button_colour=FFDD00&font_colour=000000&font_family=Arial&outline_colour=000000&coffee_colour=ffffff"></a>
|
|
|
|
## Credits
|
|
|
|
- [qBittorrent](https://github.com/qbittorrent/qBittorrent)
|
|
- Many thanks [@m4ximuel](https://github.com/m4ximuel) for designing the icon & helping out with the project
|