kitbash 1.7.0__tar.gz → 1.8.2__tar.gz

kitbash-1.8.2/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.1
+Name: kitbash
+Version: 1.8.2
+Summary: Provides universal settings, styles, cached icons, and pixmaps, and the base
+Author-email: Leon Dionne <ldionne@dridesign.sh.cn>
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Requires-Dist: log_soso >= 1.0.3
+Requires-Dist: PyQt5
+Requires-Dist: qt_liquid_pool >= 1.2.0
+Requires-Dist: recent_items_list >= 1.1.2
+Requires-Dist: sfzen >= 2.3.2
+Requires-Dist: soso_qt_extras >= 1.7.0
+Requires-Dist: xdg_soso >= 0.2.0
+Project-URL: Home, https://github.com/Zen-Master-SoSo/kitbash
+
+# KitBash
+
+A GUI application which you can use to create a new SFZ drumkit from pieces of other drumkits.
+
+## Intro
+
+Got a drumkit [SFZ](https://sfzformat.com/) that sounds pretty good, but
+there's just one instrument that doesn't quite cut it? Want to replace that one
+snare, or even that whole set of tom-toms?
+
+That's what kitbash was written for!
+
+Kitbash allows you to create projects in which you can import mutiple drumkits
+from SFZ files, select the pieces of each kit you want, then export the
+finished drumkit to a new SFZ.
+
+## Usage
+
+<img width="624" height="329" alt="kitbash-empty-window" src="https://github.com/user-attachments/assets/0b0295be-34d7-4873-9576-82b50b8d5876" />
+
+Starting with an empty project, use the "Edit" -> "Load Drumkit" menu, or click
+on the "plus" symbol in the toolbar. You'll see all the instruments defined in
+the drumkit you just loaded, grouped into categories, such as "Snares", "Tom
+toms", "Hi-hats", etc.
+
+### Audio preview
+
+To listen to audio playback, you need to select an "Audio sink" from the dropdown
+list at the top-right of the window. You audio out devices should be listed
+there. Note that this is a JACK application, and your JACK audio connection kit
+server must be running to play audio.
+
+To preview the sound of each instrument, click on the instrument name.
+Releasing the mouse stops the playback.
+
+To preview the drumkit you are assembling, you need to send it MIDI note
+events. Choose the MIDI source from the dropdown list at the top-right area of
+the window, and send MIDI events. A MIDI source can be an external device, like
+a MIDI keyboard, or the MIDI output of another program, such as
+[qtractor](https://qtractor.org/), [MuseScore](https://musescore.com/), or
+[JackMIDILooper](https://github.com/Zen-Master-SoSo/jack_midi_looper).
+
+### Instrument selection
+
+The instruments selected to be included in your final drumkit are indicated by
+the check boxes next to the instrument and category names.
+
+<img width="887" height="421" alt="kitbash-window" src="https://github.com/user-attachments/assets/56122b21-a409-4ff2-a22d-bdba960f7a91" />
+
+
+Check the box next to a category to select all the instruments in that category
+for inclusion in your new drumkit. Check the checkbox next to any individual
+instrument (i.e. "Ride Bell"), to include only that instrument.
+
+When you load the first drumkit, all categories and instruments are selected.
+Load another drumkit in the same way as you did the first (using the menu or
+the toolbar). Selecting an instrument from one drumkit de-selects that
+instrument from all other loaded drumkits.
+
+You can make changes while playing a loop from the incoming MIDI source, and
+the changes are (almost) immediately made to the "bashed" drumkit you are
+making.
+
+### Exporting an SFZ
+
+When you're satisfied with what you've selected, you can save the "bashed"
+drumkit as an .sfz file in a new location. From the menu, select "File" ->
+"Save Bashed Kit As..." and choose the location. Or, click the corresponding
+icon in the toolbar.
+
+
+### Saving a project
+
+A "project" is a list of the source SFZs and which groups and instruments from
+each them are selected. You can save a project for later, make whatever changes
+you desire, and then export the SFZ you created again. This way, you don't have
+to start from scratch every time you wish to make that one small change.
+
+
+## Install
+
+Install in the usual way:
+
+```bash
+$ pip install kitbash
+```
+
+### Requirements
+
+You'll need both [JACK audio connection kit](https://jackaudio.org/) and
+[liquidsfz](https://github.com/swesterfeld/liquidsfz) in order to have live
+previews. You can run the program without either, but you won't be able to
+listen to your changes as you are making them.
+
+To install JACK:
+
+```bash
+$ sudo apt install jackd
+```
+
+...or...
+
+```bash
+$ sudo dnf install jackd
+```
+
+To install liquidsfz:
+
+```bash
+$ git clone https://github.com/swesterfeld/liquidsfz.git
+```
+
+... and follow the instructions found in the liquidsfz README to install it.
+
+
+
+

kitbash-1.8.2/README.md

@@ -0,0 +1,116 @@
+# KitBash
+
+A GUI application which you can use to create a new SFZ drumkit from pieces of other drumkits.
+
+## Intro
+
+Got a drumkit [SFZ](https://sfzformat.com/) that sounds pretty good, but
+there's just one instrument that doesn't quite cut it? Want to replace that one
+snare, or even that whole set of tom-toms?
+
+That's what kitbash was written for!
+
+Kitbash allows you to create projects in which you can import mutiple drumkits
+from SFZ files, select the pieces of each kit you want, then export the
+finished drumkit to a new SFZ.
+
+## Usage
+
+<img width="624" height="329" alt="kitbash-empty-window" src="https://github.com/user-attachments/assets/0b0295be-34d7-4873-9576-82b50b8d5876" />
+
+Starting with an empty project, use the "Edit" -> "Load Drumkit" menu, or click
+on the "plus" symbol in the toolbar. You'll see all the instruments defined in
+the drumkit you just loaded, grouped into categories, such as "Snares", "Tom
+toms", "Hi-hats", etc.
+
+### Audio preview
+
+To listen to audio playback, you need to select an "Audio sink" from the dropdown
+list at the top-right of the window. You audio out devices should be listed
+there. Note that this is a JACK application, and your JACK audio connection kit
+server must be running to play audio.
+
+To preview the sound of each instrument, click on the instrument name.
+Releasing the mouse stops the playback.
+
+To preview the drumkit you are assembling, you need to send it MIDI note
+events. Choose the MIDI source from the dropdown list at the top-right area of
+the window, and send MIDI events. A MIDI source can be an external device, like
+a MIDI keyboard, or the MIDI output of another program, such as
+[qtractor](https://qtractor.org/), [MuseScore](https://musescore.com/), or
+[JackMIDILooper](https://github.com/Zen-Master-SoSo/jack_midi_looper).
+
+### Instrument selection
+
+The instruments selected to be included in your final drumkit are indicated by
+the check boxes next to the instrument and category names.
+
+<img width="887" height="421" alt="kitbash-window" src="https://github.com/user-attachments/assets/56122b21-a409-4ff2-a22d-bdba960f7a91" />
+
+
+Check the box next to a category to select all the instruments in that category
+for inclusion in your new drumkit. Check the checkbox next to any individual
+instrument (i.e. "Ride Bell"), to include only that instrument.
+
+When you load the first drumkit, all categories and instruments are selected.
+Load another drumkit in the same way as you did the first (using the menu or
+the toolbar). Selecting an instrument from one drumkit de-selects that
+instrument from all other loaded drumkits.
+
+You can make changes while playing a loop from the incoming MIDI source, and
+the changes are (almost) immediately made to the "bashed" drumkit you are
+making.
+
+### Exporting an SFZ
+
+When you're satisfied with what you've selected, you can save the "bashed"
+drumkit as an .sfz file in a new location. From the menu, select "File" ->
+"Save Bashed Kit As..." and choose the location. Or, click the corresponding
+icon in the toolbar.
+
+
+### Saving a project
+
+A "project" is a list of the source SFZs and which groups and instruments from
+each them are selected. You can save a project for later, make whatever changes
+you desire, and then export the SFZ you created again. This way, you don't have
+to start from scratch every time you wish to make that one small change.
+
+
+## Install
+
+Install in the usual way:
+
+```bash
+$ pip install kitbash
+```
+
+### Requirements
+
+You'll need both [JACK audio connection kit](https://jackaudio.org/) and
+[liquidsfz](https://github.com/swesterfeld/liquidsfz) in order to have live
+previews. You can run the program without either, but you won't be able to
+listen to your changes as you are making them.
+
+To install JACK:
+
+```bash
+$ sudo apt install jackd
+```
+
+...or...
+
+```bash
+$ sudo dnf install jackd
+```
+
+To install liquidsfz:
+
+```bash
+$ git clone https://github.com/swesterfeld/liquidsfz.git
+```
+
+... and follow the instructions found in the liquidsfz README to install it.
+
+
+

{kitbash-1.7.0 → kitbash-1.8.2}/kitbash/__init__.py

@@ -29,7 +29,7 @@ from PyQt5.QtCore import QSettings
 from PyQt5.QtWidgets import QApplication, QSplitter
 from qt_extras import DevilBox
 
-__version__ = "1.7.0"
+__version__ = "1.8.2"
 
 APPLICATION_NAME			= "kitbash"
 PACKAGE_DIR					= dirname(__file__)

{kitbash-1.7.0 → kitbash-1.8.2}/kitbash/gui/main_window.py

@@ -45,6 +45,7 @@ from kitbash import (
 from kitbash.worker_threads import KitLoader, KitBasher
 from kitbash.gui.drumkit_widget import DrumkitWidget
 from kitbash.gui.kit_save_dialog import KitSaveDialog
+from kitbash.install import install
 
 
 UPDATES_DEBOUNCE = 680
@@ -119,6 +120,7 @@ class MainWindow(QMainWindow, GeometrySaver):
 		self.audio.connect()
 		if self.options.Filename:
 			self.load_project(self.options.Filename)
+		install()
 
 	def setup_kits_area(self):
 		self.drumkit_widgets = VListLayout(end_space = 10)

kitbash-1.8.2/kitbash/install.py

@@ -0,0 +1,42 @@
+#  kitbash/kitbash/install.py
+#
+#  Copyright 2026 Leon Dionne <ldionne@dridesign.sh.cn>
+#
+#  This program is free software; you can redistribute it and/or modify
+#  it under the terms of the GNU General Public License as published by
+#  the Free Software Foundation; either version 2 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License
+#  along with this program; if not, write to the Free Software
+#  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+#  MA 02110-1301, USA.
+#
+"""
+Install phoney-dictate as an application on XDG-compliant systems (like gnome).
+"""
+import logging
+from os.path import dirname, join
+from xdg_soso import XDGSetup, is_xdg
+
+def install():
+	if is_xdg():
+		xdg = XDGSetup('kitbash', 'Kitbash')
+		xdg.comment = "Bash together new .SFZ drumkits from pieces of existing ones."
+		xdg.application_icon = join(dirname(__file__), 'res', 'kitbash-icon.svg')
+		xdg.categories = ['AudioVideo', 'Audio']
+		xdg.keywords = ['Audio', 'Sound', 'midi', 'SFZ', 'Drumkit']
+		xdg.install()
+
+if __name__ == '__main__':
+	log_format = "[%(filename)24s:%(lineno)4d] %(levelname)-8s %(message)s"
+	logging.basicConfig(level = logging.DEBUG, format = log_format)
+	install()
+
+
+#  end kitbash/kitbash/install.py

kitbash-1.8.2/kitbash/res/kitbash-icon.svg

@@ -0,0 +1,168 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="600"
+   height="600"
+   viewBox="0 0 600 600"
+   id="svg2"
+   version="1.1"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
+  <defs
+     id="defs4">
+    <linearGradient
+       id="linearGradient109942">
+      <stop
+         style="stop-color:#fa689e;stop-opacity:1"
+         offset="0"
+         id="stop109938" />
+      <stop
+         style="stop-color:#6b5fff;stop-opacity:0.811765"
+         offset="0.414101"
+         id="stop110522" />
+      <stop
+         style="stop-color:#be99f1;stop-opacity:0.855499"
+         offset="0.687764"
+         id="stop113297" />
+      <stop
+         style="stop-color:#ee70f2;stop-opacity:0.744947"
+         offset="1"
+         id="stop109940" />
+    </linearGradient>
+    <linearGradient
+       xlink:href="#linearGradient109942"
+       id="linearGradient109944"
+       x1="327.545"
+       y1="574.41"
+       x2="199.091"
+       y2="55.0792"
+       gradientUnits="userSpaceOnUse" />
+  </defs>
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     id="layer2"
+     style="display:inline">
+    <circle
+       style="color:#000000;display:inline;overflow:visible;mix-blend-mode:normal;fill:none;fill-opacity:0.51511;fill-rule:evenodd;stroke:#000000;stroke-width:20;stroke-linecap:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="circle57643"
+       cx="297.486"
+       cy="301.699"
+       r="267.913"
+       transform="translate(2.51401,-1.699)" />
+  </g>
+  <g
+     id="layer3"
+     style="display:inline">
+    <rect
+       style="color:#000000;overflow:visible;fill:#ffe975;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:15;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect1127"
+       width="165.361"
+       height="195.416"
+       x="53.0408"
+       y="317.732"
+       ry="15.3795"
+       rx="22"
+       transform="translate(-37.5637,37.488)" />
+    <rect
+       style="color:#000000;overflow:visible;fill:#ffe975;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:15;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect1131"
+       width="149.521"
+       height="108.756"
+       x="166.055"
+       y="306.176"
+       ry="22"
+       rx="22"
+       transform="rotate(8.96686,604.717,141.494)" />
+    <rect
+       style="color:#000000;overflow:visible;fill:#ffe975;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:15;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect1129"
+       width="148.822"
+       height="146.546"
+       x="376.526"
+       y="317.397"
+       ry="21.1672"
+       rx="22"
+       transform="translate(65.7395,44.671)" />
+    <rect
+       style="color:#000000;overflow:visible;fill:#ffe975;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:15;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect1133"
+       width="146.021"
+       height="106.396"
+       x="284.473"
+       y="278.286"
+       ry="19.4522"
+       rx="22"
+       transform="rotate(-11.0888,191.021,-0.061273)" />
+    <circle
+       style="color:#000000;overflow:visible;fill:#ffe975;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:13.0085;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="path1075"
+       cx="301.769"
+       cy="462.65"
+       r="121.371"
+       transform="translate(6.231,-11.821)" />
+    <g
+       id="g1995"
+       transform="matrix(1.05073,0,0,1.05086,-27.369,-505.308)"
+       style="stroke-width:9.5166;stroke-miterlimit:4;stroke-dasharray:none" />
+    <path
+       style="color:#000000;overflow:visible;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:24;stroke-linecap:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="m 154.978,112.499 -44.56,77.074 v 379.729"
+       id="path42213" />
+    <ellipse
+       style="color:#000000;overflow:visible;fill:#b3d4ff;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:9.36506;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="path925"
+       transform="matrix(0.997534,0.380811,-0.380788,0.997646,86.4755,-136.944)"
+       ry="21.2013"
+       rx="127.184"
+       cy="195.354"
+       cx="143.244" />
+    <path
+       id="path108988"
+       style="color:#000000;overflow:visible;fill:#ffe975;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:20;stroke-linecap:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       transform="rotate(135,569.031,406.107)"
+       d="m 703.751,308.524 v 75.828 m 0,0 h 75.828 M 435.768,652.336 703.751,384.352" />
+    <ellipse
+       style="color:#000000;overflow:visible;fill:#b3d2ff;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:9.36506;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="ellipse36115"
+       ry="13.2736"
+       rx="110.063"
+       cy="195.354"
+       cx="143.244"
+       transform="rotate(-6.21227,-344.929,-2972.27)" />
+    <use
+       x="0"
+       y="0"
+       xlink:href="#ellipse36115"
+       id="use41189"
+       transform="translate(-3.09613e-5,42.935)"
+       width="100%"
+       height="100%" />
+  </g>
+  <g
+     id="layer1"
+     transform="translate(0,-452.36)"
+     style="display:inline;mix-blend-mode:color-burn">
+    <circle
+       style="color:#000000;overflow:visible;mix-blend-mode:normal;fill:url(#linearGradient109944);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:24;stroke-linecap:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="path57575"
+       cx="297.486"
+       cy="301.699"
+       r="274.834"
+       transform="translate(2.51401,450.661)" />
+  </g>
+</svg>

{kitbash-1.7.0 → kitbash-1.8.2}/pyproject.toml

@@ -10,8 +10,9 @@ dependencies = [
 	"PyQt5",
 	"qt_liquid_pool >= 1.2.0",
 	"recent_items_list >= 1.1.2",
-	"sfzen >= 2.3.1",
-	"soso_qt_extras >= 1.7.0"
+	"sfzen >= 2.3.2",
+	"soso_qt_extras >= 1.7.0",
+	"xdg_soso >= 0.2.0"
 ]
 
 [project.urls]
@@ -26,7 +27,7 @@ requires = ["flit_core >=3.2,<4"]
 build-backend = "flit_core.buildapi"
 
 [bumpver]
-current_version = "1.7.0"
+current_version = "1.8.2"
 version_pattern = "MAJOR.MINOR.PATCH"
 commit_message = "Bump version {old_version} -> {new_version}"
 commit = true

kitbash-1.7.0/PKG-INFO

@@ -1,20 +0,0 @@
-Metadata-Version: 2.1
-Name: kitbash
-Version: 1.7.0
-Summary: Provides universal settings, styles, cached icons, and pixmaps, and the base
-Author-email: Leon Dionne <ldionne@dridesign.sh.cn>
-Description-Content-Type: text/markdown
-Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
-Requires-Dist: log_soso >= 1.0.3
-Requires-Dist: PyQt5
-Requires-Dist: qt_liquid_pool >= 1.2.0
-Requires-Dist: recent_items_list >= 1.1.2
-Requires-Dist: sfzen >= 2.3.1
-Requires-Dist: soso_qt_extras >= 1.7.0
-Project-URL: Home, https://github.com/Zen-Master-SoSo/kitbash
-
-# KitBash
-
-A GUI application which you can use to create a new .sfz drumkit from pieces of other drumkits.
-
-

kitbash-1.7.0/README.md

@@ -1,4 +0,0 @@
-# KitBash
-
-A GUI application which you can use to create a new .sfz drumkit from pieces of other drumkits.
-