2 | the kanagawa theme for qBittorrent 3 |
4 | 5 | > ⚠️ seeking contributions: [icons needed](#contributing) 6 | 7 |
8 | 
9 |
10 | colorscheme: kanagawa • qBittorrent
11 |
30 | 
31 |
38 |
39 |
40 | ## installation
41 |
42 | > as a TLDR,
43 | > For any theme on qBittorrent,
44 | > - Get the `*.qbtheme` file. In this case, this is [`kanagawa.qbtheme`](https://github.com/esskayesss/kanagawa-qbtheme/blob/main/kanagawa.qbtheme)
45 | > - In your qBittorrent settings, browse into `Behavior -> Interface` section
46 | > - choose the downloaded file for the `UI Theme file` option after checking the `Use Custom UI Theme` checkbox.
47 | >
48 | > You can find more themes and yet another guide [here](https://github.com/jagannatharjun/qbt-theme)
49 |
50 | 1. **Download the theme file:**
51 | - Download [`kanagawa.qbtheme`](https://github.com/esskayesss/kanagawa-qbtheme/blob/main/kanagawa.qbtheme) by clicking on the `Download raw file` button.
52 | - Alternatively, you can clone the repository in a folder of your choice to be able to pull for new changes.
53 | 2. **Move the file into a theme folder:**
54 | - Locate the extracted file and move it to a qBittorrent themes directory. This can be anywhere, but for the sake of organization, I use the following paths:
55 | - For Windows: `C:\Users\YourUsername\qBittorrent\themes`
56 | - For Linux: `~/.config/qBittorrent/themes`
57 |
58 | 3. **Select the theme:**
59 | - Open qBittorrent and go to `Tools -> Options -> Behavior`.
31 |
32 | For qBittorrent, I've taken the plunge with the kanagawa theme, which stands out as an exceptionally refined colorscheme.
33 | It's one of the most perfect colorschemes I've come across of late. I was enjoying how pleasant Gruvbox was to the eye and yet wanted something darker.
34 | I will be using a darker configuration of it extensively throughout my rice, all of which can be
35 | found in the dots repository. A big shout-out to the creator for making the palette public.
36 |
60 | In case of a Mac, this will be `Preferences -> Behavior` 61 | - Here, in the interface section, check the `User custom UI Theme` option. 62 | - Proceed to select the `kanagawa.qbtheme` file from the file explorer for the `UI Theme file:` option. 63 | 64 | 4. **Restart qBittorrent:** 65 | - Close and reopen qBittorrent for the changes to take effect. 66 | 67 | That's it! Your new theme should now be applied to qBittorrent. 68 | 69 | 70 | ## contributing 71 | 72 | **We're on the lookout for contributors!** 🚀 73 | 74 | - **Especially for icon design:** Tailored to match the Kanagawa theme's pastel tones. 75 | - **Make an impact:** Your icons are the missing pieces to complete our aesthetic puzzle. 76 | 77 | Jump in and help us craft a cohesive and visually appealing experience for qBittorrent users! 78 | We look forward to seeing your creative contributions. Together, we can make the Kanagawa theme for qBittorrent even more beautiful and user-friendly! 79 | -------------------------------------------------------------------------------- /tools/make-resource.py: -------------------------------------------------------------------------------- 1 | import subprocess 2 | import glob 3 | import argparse 4 | import os.path 5 | import sys 6 | import fnmatch 7 | import re 8 | 9 | 10 | def allFiles(glob): 11 | [dir, pattern] = os.path.split(glob) 12 | l = list() 13 | for root, subdir, files in os.walk(dir): 14 | l.extend([os.path.join(root, x) for x in files if fnmatch.fnmatch(x, pattern)]) 15 | return l 16 | 17 | 18 | parser = argparse.ArgumentParser(description="helper to create qbtthemes") 19 | parser.add_argument( 20 | "-output", type=str, help="output qbtheme file", default="style.qbtheme" 21 | ) 22 | parser.add_argument("-style", type=str, help="stylesheet", required=True) 23 | parser.add_argument("-base-dir", type=str, dest="baseDir", default=".") 24 | parser.add_argument( 25 | "-icons-dir", 26 | type=str, 27 | dest="iconsDir", 28 | default="", 29 | help="directory which contains custom icons", 30 | ) 31 | parser.add_argument( 32 | "-dir-prefix", 33 | type=str, 34 | default="", 35 | dest="dirPrefix", 36 | help="prefix added to all files", 37 | ) 38 | parser.add_argument( 39 | "-config", type=str, dest="config", default=None, help="file used as config.json" 40 | ) 41 | parser.add_argument( 42 | "-find-files", 43 | action="store_true", 44 | dest="findFiles", 45 | help="find files included in qss and only include those", 46 | ) 47 | parser.add_argument( 48 | "files", 49 | metavar="files", 50 | type=str, 51 | nargs="*", 52 | default=["*"], 53 | help="files to include in resources from baseDir, supports glob patterns", 54 | ) 55 | 56 | args = parser.parse_args() 57 | 58 | if not args.output.endswith(".qbtheme"): 59 | args.output += ".qbtheme" 60 | 61 | if os.path.exists(args.output): 62 | print("WARNING! %s already exists. overwriting" % (args.output)) 63 | 64 | 65 | files = allFiles(os.path.join(args.baseDir, "*")) 66 | if args.findFiles: 67 | print("finding files") 68 | args.files = [] 69 | stylesheet = open(os.path.join(args.baseDir, args.style)).read() 70 | for f in re.findall(":\/uitheme\/(.*)\)", stylesheet): 71 | args.files.append(f) 72 | 73 | config_file = None 74 | if args.config: 75 | if os.path.exists(args.config): 76 | config_file = args.config 77 | elif os.path.exists(os.path.join(args.baseDir, args.config)): 78 | config_file = os.path.join(args.baseDir, args.config) 79 | 80 | ResourceFiles = list() 81 | for f in files: 82 | alias = os.path.relpath(f, args.baseDir) 83 | for i in args.files: 84 | if fnmatch.fnmatch(alias, i): 85 | ResourceFiles.append((alias, f)) 86 | print("adding " + f) 87 | break 88 | 89 | IconFiles = ( 90 | list() 91 | if not args.iconsDir 92 | else [f for f in glob.glob(os.path.join(args.iconsDir, "*"))] 93 | ) 94 | print(IconFiles) 95 | 96 | with open("resources.qrc", "w") as rcc: 97 | rcc.write('