bhardwajRahul / VueTorrent

The sleekest looking WEBUI for qBittorrent made with Vuejs!

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

VueTorrent

VueTorrent

The sleekest looking WebUI for qBittorrent made with Vue.js!

Join us on Discord

Vue qBittorrent Vuetify

stars Forks Issues Closed Closed PR Version Test Status Downloads

Screenshots

  • Desktop

Screenshot Desktop (Light Mode)

  • Desktop Dark Mode

Screenshot Desktop (Dark Mode)

  • Mobile Dark Mode

Screenshot Mobile Dashboard (Dark Mode) Screenshot Mobile Dashboard (Light Mode)

Installation

Manual

  • Visit the 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

Alternative methods - May work for older QBit versions

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!
    • Mac keymap is supported (use Cmd instead of Ctrl)
    • Press Escape to dismiss any dialogs or to return to Dashboard view
    • Dashboard
      • Select all torrents with Ctrl-A
      • Focus search input with Ctrl-F
        • Press again to enable native browser search
      • When no dialogs are opened, press Escape to unfocus search input
        • Press again to unselect all torrents
      • Delete selected torrents with Delete (Fn-Backspace on Mac)
      • Ctrl-click on a torrent card to enable multi-select mode and select it
      • Hold Shift and click on a torrent card to select all torrents between the last selected torrent and the clicked 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

Localize the app

To help us localize VueTorrent, you will need to:

  • src/locales/<your language>.json
    • Create a json file containing the translations by matching the structure of en.json
      • every key may not be specified, that's fine, it will default to the english locale
    • <your language> should match the ISO 639 locale code of the added language
  • src/locales/locales.ts
    • add your language to the Locales enum, it should match the json filename
    • Update the LOCALES constant with the local language name and the created enum value
  • src/locales/index.ts
    • import the json file
    • include it in the messages object using the created enum value as key

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

Contributors

About

The sleekest looking WEBUI for qBittorrent made with Vuejs!


Languages

Language:Vue 65.2%Language:TypeScript 33.8%Language:SCSS 0.7%Language:HTML 0.2%Language:JavaScript 0.1%