# Changelog
Source: https://mkbrr.com/changelog
Latest updates and improvements to mkbrr
### Breaking Changes
* [21ba448](https://github.com/autobrr/mkbrr/commit/21ba448d1c52bcce9ead8b0acba67e3ca8ba3d05): Add exact pre-hash plan mode ([#202](https://github.com/autobrr/mkbrr/pull/202)) (@maghuro)
* [b599319](https://github.com/autobrr/mkbrr/commit/b5993192c3da3b30b8d86fa7757f88d615b7840e): Add --no-entropy and keep/set/clear for modify ([#225](https://github.com/autobrr/mkbrr/pull/225)) (@s0up4200)
* [554fdc6](https://github.com/autobrr/mkbrr/commit/554fdc606b19b84a6d65966929c8a5ca732517fe): Share one create settings type between CLI, GUI and batch ([#228](https://github.com/autobrr/mkbrr/pull/228)) (@s0up4200)
* [87af7ca](https://github.com/autobrr/mkbrr/commit/87af7ca76fc88e0f752ca47429c8b6679ffa2989): Respect effective minimum for max piece length ([#204](https://github.com/autobrr/mkbrr/pull/204)) (@maghuro)
* [ac2a443](https://github.com/autobrr/mkbrr/commit/ac2a443ac5194a673a670be82c4704b66b41cd82): Resolve create options in one place ([#215](https://github.com/autobrr/mkbrr/pull/215)) (@s0up4200)
* [96e4955](https://github.com/autobrr/mkbrr/commit/96e4955fccdb4f5bfcd9d07e715f6c1be9935ab6): Reject create flags with --batch ([#244](https://github.com/autobrr/mkbrr/pull/244)) (@s0up4200)
### Bug fixes
* [45b6189](https://github.com/autobrr/mkbrr/commit/45b618953d15f393c6083a4a73571e2d8034f179): Use typed atomics for verifier counters ([#210](https://github.com/autobrr/mkbrr/pull/210)) (@s0up4200)
* [e76a3b3](https://github.com/autobrr/mkbrr/commit/e76a3b3744943e13f3a78c339e7e8624afbda734): Write torrent metadata in one place for create and modify ([#217](https://github.com/autobrr/mkbrr/pull/217)) (@s0up4200)
* [a8fd061](https://github.com/autobrr/mkbrr/commit/a8fd061afb095940fa503c7f660c8cbfb7c1786f): List breaking changes first in the changelog ([#226](https://github.com/autobrr/mkbrr/pull/226)) (@s0up4200)
* [13e0890](https://github.com/autobrr/mkbrr/commit/13e08901a5f30f75d8870e498b0c63ae429a2728): Exit with an error when a batch job fails ([#233](https://github.com/autobrr/mkbrr/pull/233)) (@cestercian)
* [39c3b1d](https://github.com/autobrr/mkbrr/commit/39c3b1d40927773210ade3215d22dccffb528784): Read skip\_prefix from the preset ([#248](https://github.com/autobrr/mkbrr/pull/248)) (@s0up4200)
### Other work
* [7d97064](https://github.com/autobrr/mkbrr/commit/7d9706407f6383b0513751d0a514c8a029eac5e6): Trigger the mkbrr.com docs update on release ([#205](https://github.com/autobrr/mkbrr/pull/205)) (@s0up4200)
* [01696d4](https://github.com/autobrr/mkbrr/commit/01696d48facbc45136427773ed7ce06d70d8dc86): Bump the golang group across 2 directories with 4 updates ([#206](https://github.com/autobrr/mkbrr/pull/206)) (@dependabot\[bot])
* [b4e092f](https://github.com/autobrr/mkbrr/commit/b4e092f8e8e67cfb09413366e17eae294a77dce4): Update dependencies and remove stray lockfile ([#207](https://github.com/autobrr/mkbrr/pull/207)) (@s0up4200)
* [9fcfeab](https://github.com/autobrr/mkbrr/commit/9fcfeab3ef584755a06b92e2e5d1bae1196a2038): Build the frontend with pnpm 11 ([#208](https://github.com/autobrr/mkbrr/pull/208)) (@s0up4200)
* [b3d455a](https://github.com/autobrr/mkbrr/commit/b3d455a13769acf67e6f46f8cf1c58d98d1e13b3): Add agent skills config ([#209](https://github.com/autobrr/mkbrr/pull/209)) (@s0up4200)
* [8da79fa](https://github.com/autobrr/mkbrr/commit/8da79fa1d1f87e01c70c068db22fc3bb120cdad8): Add glossary for create settings ([#214](https://github.com/autobrr/mkbrr/pull/214)) (@s0up4200)
* [ed94056](https://github.com/autobrr/mkbrr/commit/ed94056b05fedd5711c5c2442ae9ddb070362422): Add pull request template ([#216](https://github.com/autobrr/mkbrr/pull/216)) (@s0up4200)
* [d8b853b](https://github.com/autobrr/mkbrr/commit/d8b853bda4a82b3e5c9450ffeb33e8bb1f3d1beb): Require ! in the title of a PR with the BREAKING CHANGE label ([#227](https://github.com/autobrr/mkbrr/pull/227)) (@s0up4200)
* [a018533](https://github.com/autobrr/mkbrr/commit/a01853373b1dfd0785ff0564f5559322aad994cc): Add settings parity test for the CLI, batch, presets, and GUI ([#229](https://github.com/autobrr/mkbrr/pull/229)) (@s0up4200)
* [aad96c6](https://github.com/autobrr/mkbrr/commit/aad96c6b60dd778f43ba2154041ca45fbd5c1801): Move the mkbrr.com docs site into this repository ([#235](https://github.com/autobrr/mkbrr/pull/235)) (@s0up4200)
* [b8d8113](https://github.com/autobrr/mkbrr/commit/b8d8113794d71c1364103c8a654a6c385047b1ca): Add the Mintlify agent skill ([#238](https://github.com/autobrr/mkbrr/pull/238)) (@s0up4200)
* [405d9e6](https://github.com/autobrr/mkbrr/commit/405d9e607f598c889b94c20f84cd4af765799923): Port the unreleased docs from the old mkbrr.com repository ([#237](https://github.com/autobrr/mkbrr/pull/237)) (@s0up4200)
* [79235f0](https://github.com/autobrr/mkbrr/commit/79235f03d23ab10d72b93fbc71d21a6b00673d5a): Add release steps, AI review rules, and a CodeRabbit config ([#239](https://github.com/autobrr/mkbrr/pull/239)) (@s0up4200)
* [d067f8f](https://github.com/autobrr/mkbrr/commit/d067f8feadf0c04d31299002ae5181cc3f837a74): Drop the removed Homebrew tap ([#240](https://github.com/autobrr/mkbrr/pull/240)) (@s0up4200)
* [0befa4b](https://github.com/autobrr/mkbrr/commit/0befa4be071dbc185209a2badc4492c857db4134): Note the Mintlify plan and compare README install steps ([#242](https://github.com/autobrr/mkbrr/pull/242)) (@s0up4200)
* [caefdab](https://github.com/autobrr/mkbrr/commit/caefdab41c82a3a94f1f95a116b69caadfc8b54a): Put the piece-length decision in one pure function ([#231](https://github.com/autobrr/mkbrr/pull/231)) (@s0up4200)
* [d2259d4](https://github.com/autobrr/mkbrr/commit/d2259d45534221639026365560124442a83ede1b): Review PRs to main ([#245](https://github.com/autobrr/mkbrr/pull/245)) (@s0up4200)
* [dead155](https://github.com/autobrr/mkbrr/commit/dead155395ed78fb9bdf24a0eb71c821859f6b91): Add the Mintlify agent skill to main ([#246](https://github.com/autobrr/mkbrr/pull/246)) (@s0up4200)
* [3b1d399](https://github.com/autobrr/mkbrr/commit/3b1d3990dff7f5ff7240790809c9944aa8d2bab6): Fix errors from the old docs site ([#243](https://github.com/autobrr/mkbrr/pull/243)) (@s0up4200)
* [db65319](https://github.com/autobrr/mkbrr/commit/db653193ff19a493f30f06ab46502534a1e953a0): Add the needs-grilling triage label ([#249](https://github.com/autobrr/mkbrr/pull/249)) (@s0up4200)
**Full Changelog**: [v1.26.0...v1.27.0](https://github.com/autobrr/mkbrr/compare/v1.26.0...v1.27.0)
### Contributors
* @s0up4200
* @dependabot\[bot]
* @cestercian
* @maghuro
### New Features
* [5fc15cc](https://github.com/autobrr/mkbrr/commit/5fc15cc5309f13ddfaa714bbeaea8407cc516edc): Add Portugas.org rules ([#199](https://github.com/autobrr/mkbrr/pull/199)) (@maghuro)
* [65ccb97](https://github.com/autobrr/mkbrr/commit/65ccb973addb97464d0b92eb705ce075a9d71e0f): Honor explicit tracker piece-size ranges ([#201](https://github.com/autobrr/mkbrr/pull/201)) (@maghuro)
### Other work
* [0f1926e](https://github.com/autobrr/mkbrr/commit/0f1926e1c317a928fa22b1074db280efe17de947): Remove Claude code review workflow ([#203](https://github.com/autobrr/mkbrr/pull/203)) (@s0up4200)
* [30e7fb5](https://github.com/autobrr/mkbrr/commit/30e7fb5666c4fc459ab8945c2400c8a3df325cb4): Fix test that depend on the local timezone ([#197](https://github.com/autobrr/mkbrr/pull/197)) (@n-peugnet)
**Full Changelog**: [v1.25.1...v1.26.0](https://github.com/autobrr/mkbrr/compare/v1.25.1...v1.26.0)
### Contributors
* @maghuro
* @s0up4200
* @n-peugnet
### Bug fixes
* [e41a261](https://github.com/autobrr/mkbrr/commit/e41a261b7f8cff20c482dad050416de9d8cd5db6): Prepare GUI modules and skip bot reviews ([#195](https://github.com/autobrr/mkbrr/pull/195)) (@s0up4200)
### Other work
* [d9526d1](https://github.com/autobrr/mkbrr/commit/d9526d15e13feb2a3f9670ae97bd3b0226155376): Cap read buffers and bound open file descriptors ([#188](https://github.com/autobrr/mkbrr/pull/188)) (@s0up4200)
* [acfce7b](https://github.com/autobrr/mkbrr/commit/acfce7b1c45153dc0a5ac63cf8d8fb165448d6e5): Bump Go to 1.27 ([#186](https://github.com/autobrr/mkbrr/pull/186)) (@s0up4200)
* [7ebbfe6](https://github.com/autobrr/mkbrr/commit/7ebbfe67e625758360dc316c0872e91adef37c30): Add copyright notices and SPDX headers ([#194](https://github.com/autobrr/mkbrr/pull/194)) (@s0up4200)
* [1d35b29](https://github.com/autobrr/mkbrr/commit/1d35b29c8fea453e03b9e9a2abd103e2f74b81bb): Bump the golang group across 2 directories with 5 updates ([#191](https://github.com/autobrr/mkbrr/pull/191)) (@dependabot\[bot])
**Full Changelog**: [v1.25.0...v1.25.1](https://github.com/autobrr/mkbrr/compare/v1.25.0...v1.25.1)
### Contributors
* @s0up4200
* @dependabot\[bot]
### New Features
* [e99dc06](https://github.com/autobrr/mkbrr/commit/e99dc06ee7ad0ccbd0512ae354960200ed4cbf93): Reuse hashes when updating files ([#179](https://github.com/autobrr/mkbrr/pull/179)) (@ShivamB25)
**Full Changelog**: [v1.24.1...v1.25.0](https://github.com/autobrr/mkbrr/compare/v1.24.1...v1.25.0)
### Contributors
* @ShivamB25
### Bug fixes
* [f32da2a](https://github.com/autobrr/mkbrr/commit/f32da2a258b4acd048d631c3bb656fadd68084c1): Normalize decomposed filenames to NFC ([#183](https://github.com/autobrr/mkbrr/pull/183)) (@s0up4200)
### Other work
* [786882e](https://github.com/autobrr/mkbrr/commit/786882e3f13607b4aeb635aa2a54cd2c26330bcb): Bump the github group with 2 updates ([#178](https://github.com/autobrr/mkbrr/pull/178)) (@dependabot\[bot])
* [cc3d21d](https://github.com/autobrr/mkbrr/commit/cc3d21d9c2e9705fc0de89ad001079beaa5834da): Bump Go to 1.26 ([#180](https://github.com/autobrr/mkbrr/pull/180)) (@s0up4200)
* [f3f9c1f](https://github.com/autobrr/mkbrr/commit/f3f9c1f2cecc64d4577f2684ea7daa55daaaa6e7): Migrate anacrolix/torrent to autobrr/go-torrent ([#181](https://github.com/autobrr/mkbrr/pull/181)) (@zze0s)
**Full Changelog**: [v1.24.0...v1.24.1](https://github.com/autobrr/mkbrr/compare/v1.24.0...v1.24.1)
### Contributors
* @dependabot\[bot]
* @s0up4200
* @zze0s
### New Features
* [299a21d](https://github.com/autobrr/mkbrr/commit/299a21d2a9cb72cace80db169934cf1128786cdf): Add drag and drop support ([#169](https://github.com/autobrr/mkbrr/pull/169)) (@gl0ryus)
### Bug fixes
* [b94721d](https://github.com/autobrr/mkbrr/commit/b94721d60b63539af171ce27652d47bba66440ae): Prevent blank screen in GUI when all presets are deleted ([#168](https://github.com/autobrr/mkbrr/pull/168)) (@gl0ryus)
* [156c996](https://github.com/autobrr/mkbrr/commit/156c996fc6f4316b650233ecbd2acfdb0e7f98ef): Harden GUI against blank-screen render crashes ([#170](https://github.com/autobrr/mkbrr/pull/170)) (@s0up4200)
* [c32116d](https://github.com/autobrr/mkbrr/commit/c32116d3fcd51a2347b815814add80e40571e6f5): Add missing skip\_prefix and fail\_on\_season\_warning to batch schema ([#171](https://github.com/autobrr/mkbrr/pull/171)) (@s0up4200)
* [2cf20a4](https://github.com/autobrr/mkbrr/commit/2cf20a46374c328a4bb2324f0f5852240081cd8c): Allow workers 0 (auto) and up to 64 to match CLI ([#176](https://github.com/autobrr/mkbrr/pull/176)) (@s0up4200)
### Other work
* [5b24d79](https://github.com/autobrr/mkbrr/commit/5b24d79a315774392a22ef68b65b2efcbd10432d): Bump the github group with 4 updates ([#167](https://github.com/autobrr/mkbrr/pull/167)) (@dependabot\[bot])
* [35daa3a](https://github.com/autobrr/mkbrr/commit/35daa3afeeb4866915857dd952b092f288b8d22b): Bump actions/checkout from 6 to 7 in the github group ([#172](https://github.com/autobrr/mkbrr/pull/172)) (@dependabot\[bot])
* [b038989](https://github.com/autobrr/mkbrr/commit/b038989e47a3c7bf13cfe58dd1783352b4087ecd): Bump github.com/schollz/progressbar/v3 from 3.19.0 to 3.19.1 in the golang group ([#174](https://github.com/autobrr/mkbrr/pull/174)) (@dependabot\[bot])
**Full Changelog**: [v1.23.0...v1.24.0](https://github.com/autobrr/mkbrr/compare/v1.23.0...v1.24.0)
### Contributors
* @dependabot\[bot]
* @gl0ryus
* @s0up4200
### New Features
* [d89efe2](https://github.com/autobrr/mkbrr/commit/d89efe2c5c500eecb78d9dd1f49ffbfb4923fa94): Add cross-platform desktop GUI using Wails ([#165](https://github.com/autobrr/mkbrr/pull/165)) (@sammy44nts)
### Other work
* [1f9149e](https://github.com/autobrr/mkbrr/commit/1f9149eb005382b715954214abebb26beb382dfd): Bump actions/checkout from 4 to 6 in the github group across 1 directory ([#160](https://github.com/autobrr/mkbrr/pull/160)) (@dependabot\[bot])
* [d93e9cb](https://github.com/autobrr/mkbrr/commit/d93e9cbf43119f5c86f674f06475d074c0773204): Streamline hashing and verification hot paths ([#164](https://github.com/autobrr/mkbrr/pull/164)) (@s0up4200)
**Full Changelog**: [v1.22.0...v1.23.0](https://github.com/autobrr/mkbrr/compare/v1.22.0...v1.23.0)
### Contributors
* @dependabot\[bot]
* @sammy44nts
* @s0up4200
### New Features
* [3f6f53e](https://github.com/autobrr/mkbrr/commit/3f6f53e2d636a64ee639a82241fe0b7585318db7): Update Aither piece size ranges ([#162](https://github.com/autobrr/mkbrr/pull/162)) (@spin-drift)
### Bug fixes
* [b16fb13](https://github.com/autobrr/mkbrr/commit/b16fb1312a64a97ce10f74b0f9bc654d9797c581): Increase TorrentLeech max piece length from 2^24 to 2^27 ([#161](https://github.com/autobrr/mkbrr/pull/161)) (@s0up4200)
**Full Changelog**: [v1.21.0...v1.22.0](https://github.com/autobrr/mkbrr/compare/v1.21.0...v1.22.0)
### Contributors
* @spin-drift
* @s0up4200
### New Features
* [9326b63](https://github.com/autobrr/mkbrr/commit/9326b63e07968744924eeb6d83df15cb421233df): Add name argument ([#141](https://github.com/autobrr/mkbrr/pull/141)) (@illutr0n)
* [89779bf](https://github.com/autobrr/mkbrr/commit/89779bf4de4edf7bf77a782c1beb1a712335af41): Add onlyencodes piece rules ([#150](https://github.com/autobrr/mkbrr/pull/150)) (@s0up4200)
* [34c8312](https://github.com/autobrr/mkbrr/commit/34c8312bb311b90e3dbad9e86969317e4a9311b2): Support path-based glob patterns ([#147](https://github.com/autobrr/mkbrr/pull/147)) (@tetrahydroc)
* [1c5affa](https://github.com/autobrr/mkbrr/commit/1c5affaa37f1899d3a3ae58a02d5e04e52e6861b): Add ability to remove private/source/comment fields ([#153](https://github.com/autobrr/mkbrr/pull/153)) (@s0up4200)
* [34606fc](https://github.com/autobrr/mkbrr/commit/34606fcaa5734e9c3d3e4d478245f1a641750a45): Add --target-piece-count option ([#156](https://github.com/autobrr/mkbrr/pull/156)) (@s0up4200)
### Bug fixes
* [62b1596](https://github.com/autobrr/mkbrr/commit/62b1596ec979e46d98ea886969f288eef33d4204): Use non-deprecated formats syntax in archives (@s0up4200)
* [cd5ba11](https://github.com/autobrr/mkbrr/commit/cd5ba11bea7830391afc85ab8613c1aa2c459e53): Apply entropy option from preset during modify ([#151](https://github.com/autobrr/mkbrr/pull/151)) (@s0up4200)
* [5466955](https://github.com/autobrr/mkbrr/commit/5466955518d832a8e17cc3b0699cf97c6d88682f): Add entropy support to batch mode ([#152](https://github.com/autobrr/mkbrr/pull/152)) (@s0up4200)
* [3ad0aee](https://github.com/autobrr/mkbrr/commit/3ad0aee53e88da0f03ab35637cfcf097818a9747): Use torrent-level byte offsets for multi-file verification ([#154](https://github.com/autobrr/mkbrr/pull/154)) (@s0up4200)
* [b9c78e1](https://github.com/autobrr/mkbrr/commit/b9c78e134d74ca4ad0cfa179270f329c3178efbc): Remove self-managed homebrew tap ([#157](https://github.com/autobrr/mkbrr/pull/157)) (@s0up4200)
### Other work
* [9f5cd2f](https://github.com/autobrr/mkbrr/commit/9f5cd2f54e66eaa35c6c960249e8867e3b4f4378): Add .pre-commit-config.yaml for code quality checks and update .gitignore to include .envrc (@s0up4200)
* [4a5481b](https://github.com/autobrr/mkbrr/commit/4a5481b860d75da35c23647740c524d0e86cdd55): Bump the github group with 2 updates ([#129](https://github.com/autobrr/mkbrr/pull/129)) (@dependabot\[bot])
* [1e167db](https://github.com/autobrr/mkbrr/commit/1e167dbf0b241998d6d695bd937e91e244cbcd23): Bump the golang group with 4 updates ([#130](https://github.com/autobrr/mkbrr/pull/130)) (@dependabot\[bot])
* [6e8c93c](https://github.com/autobrr/mkbrr/commit/6e8c93c6cb6052fe35a1b398f52f4a5567f532bb): Include Buy Me a Coffee and Ko-fi links (@s0up4200)
* [79cef17](https://github.com/autobrr/mkbrr/commit/79cef171b91d26965fce16181a59f91f398e0baa): Replace custom min/max with go1.21+ native builtins ([#142](https://github.com/autobrr/mkbrr/pull/142)) (@fabricionaweb)
* [ad74e56](https://github.com/autobrr/mkbrr/commit/ad74e5652ecd9c011f50717aa73cfccf3930cba5): Bump the github group with 3 updates ([#143](https://github.com/autobrr/mkbrr/pull/143)) (@dependabot\[bot])
* [7d59bca](https://github.com/autobrr/mkbrr/commit/7d59bca59d0e8eadebf709165bbde508ed3d46e1): Bump github.com/anacrolix/torrent in the golang group ([#144](https://github.com/autobrr/mkbrr/pull/144)) (@dependabot\[bot])
* [b46ed88](https://github.com/autobrr/mkbrr/commit/b46ed882ce308cbee8790ed746a7bd090259f193): Add new tracker configuration for torrentleech.org ([#139](https://github.com/autobrr/mkbrr/pull/139)) (@illutr0n)
* [c3ac2c5](https://github.com/autobrr/mkbrr/commit/c3ac2c5f3ad7c38870da872b7015140dd72cf222): Bump the github group with 5 updates ([#145](https://github.com/autobrr/mkbrr/pull/145)) (@dependabot\[bot])
* [a06c966](https://github.com/autobrr/mkbrr/commit/a06c9661f1416f48917d6ffa1c363d50f008638b): Update installation instructions for Homebrew ([#146](https://github.com/autobrr/mkbrr/pull/146)) (@chrisfinazzo)
* [61efa7d](https://github.com/autobrr/mkbrr/commit/61efa7d15a23dce3ec02859b9c37f8dc309fdf44): Bump github.com/fatih/color from 1.18.0 to 1.19.0 in the golang group ([#155](https://github.com/autobrr/mkbrr/pull/155)) (@dependabot\[bot])
* [4c952ed](https://github.com/autobrr/mkbrr/commit/4c952ed23a00726294212a3a1cafb8b1542fd88a): Add Claude Code GitHub Workflow ([#158](https://github.com/autobrr/mkbrr/pull/158)) (@s0up4200)
**Full Changelog**: [v1.20.0...v1.21.0](https://github.com/autobrr/mkbrr/compare/v1.20.0...v1.21.0)
### Contributors
* @s0up4200
* @dependabot\[bot]
* @fabricionaweb
* @illutr0n
* @chrisfinazzo
* @tetrahydroc
### New Features
* [2528c79](https://github.com/autobrr/mkbrr/commit/2528c79d20457df94e02a713f4a8251592758954): Add homebrew formula generation to goreleaser ([#135](https://github.com/autobrr/mkbrr/pull/135)) (@s0up4200)
### Bug fixes
* [dc7cb4c](https://github.com/autobrr/mkbrr/commit/dc7cb4c3ce0b76c9c64190221ce6ef2d9bb0d6ba): Use HOMEBREW\_TAP\_GITHUB\_TOKEN for tap access (@s0up4200)
* [e37bab6](https://github.com/autobrr/mkbrr/commit/e37bab634faa07106a24e1e29e8d995804de7d14): Pass HOMEBREW\_TAP\_GITHUB\_TOKEN to goreleaser (@s0up4200)
**Full Changelog**: [v1.19.0...v1.20.0](https://github.com/autobrr/mkbrr/compare/v1.19.0...v1.20.0)
### Contributors
* @s0up4200
### New Features
* [577f795](https://github.com/autobrr/mkbrr/commit/577f795867616b0230224cdc3499c2f562b3acd7): Show magnet link in inspect output ([#120](https://github.com/autobrr/mkbrr/pull/120)) (@IonBazan)
### Other work
* [43ba795](https://github.com/autobrr/mkbrr/commit/43ba795d7ce97f47f4480a857ffc77cf497b9d25): Use separate tiers for multiple trackers ([#124](https://github.com/autobrr/mkbrr/pull/124)) (@s0up4200)
* [9ce168b](https://github.com/autobrr/mkbrr/commit/9ce168bdf9875449e4bcd2c073c45f841c9b2769): Bump actions/checkout from 5 to 6 in the github group ([#125](https://github.com/autobrr/mkbrr/pull/125)) (@dependabot\[bot])
**Full Changelog**: [v1.18.0...v1.19.0](https://github.com/autobrr/mkbrr/compare/v1.18.0...v1.19.0)
### Contributors
* @IonBazan
* @s0up4200
* @dependabot\[bot]
### Bug fixes
* [c336c1d](https://github.com/autobrr/mkbrr/commit/c336c1d7c7aed00826c75b1089ee1c0e3dd40eb2): Ignore synology metadata directories ([#122](https://github.com/autobrr/mkbrr/pull/122)) (@s0up4200)
### Other work
* [c73d213](https://github.com/autobrr/mkbrr/commit/c73d213ecb942b09fdbf84877104548888cc2ba6): Bump the github group with 2 updates ([#121](https://github.com/autobrr/mkbrr/pull/121)) (@dependabot\[bot])
* [0d83712](https://github.com/autobrr/mkbrr/commit/0d8371230ad262891a4bd8690f83de60a5221e62): Update funding information in FUNDING.yml (@s0up4200)
**Full Changelog**: [v1.17.0...v1.18.0](https://github.com/autobrr/mkbrr/compare/v1.17.0...v1.18.0)
### Contributors
* @dependabot\[bot]
* @s0up4200
### Bug fixes
* [d7872be](https://github.com/autobrr/mkbrr/commit/d7872be8d441547b34a2f6a82379e3c940d2a745): Set default workers in profile ([#119](https://github.com/autobrr/mkbrr/pull/119)) (@IonBazan)
### Other work
* [98ae784](https://github.com/autobrr/mkbrr/commit/98ae78468068071360c6e485e49ec5c3df724d5c): Update types.go (@s0up4200)
* [e26ee58](https://github.com/autobrr/mkbrr/commit/e26ee58151cbd226be8072e9da7118d9c12aee50): Bump actions/setup-go from 5 to 6 in the github group ([#110](https://github.com/autobrr/mkbrr/pull/110)) (@dependabot\[bot])
* [bebfd8c](https://github.com/autobrr/mkbrr/commit/bebfd8c5a96b5ca9e51c443e90dbdad349da0760): Allow inspecting multiple torrent files ([#118](https://github.com/autobrr/mkbrr/pull/118)) (@IonBazan)
* [a1e30b5](https://github.com/autobrr/mkbrr/commit/a1e30b583a873d2e9c46eb8a4529613644505a47): Do not create announce list for single tracker ([#117](https://github.com/autobrr/mkbrr/pull/117)) (@IonBazan)
* [4381d8d](https://github.com/autobrr/mkbrr/commit/4381d8de1568d8fbcfb99ef2d21641f385736c45): Update to Go 1.25 ([#109](https://github.com/autobrr/mkbrr/pull/109)) (@s0up4200)
* [59b6edc](https://github.com/autobrr/mkbrr/commit/59b6edce60f5d1ded2b9faf47a841656c74d4414): Bump the golang group across 1 directory with 4 updates ([#113](https://github.com/autobrr/mkbrr/pull/113)) (@dependabot\[bot])
**Full Changelog**: [v1.16.0...v1.17.0](https://github.com/autobrr/mkbrr/compare/v1.16.0...v1.17.0)
### Contributors
* @s0up4200
* @dependabot\[bot]
* @IonBazan
### New Features
* [814682d](https://github.com/autobrr/mkbrr/commit/814682d95592203842db63155561ded9af514a21): Add sources and more trackers ([#107](https://github.com/autobrr/mkbrr/pull/107)) (@fabricionaweb)
* [0df5fee](https://github.com/autobrr/mkbrr/commit/0df5fee3f525ecfa962aa6e96a46b8fa9c898095): Make mkbrr usable as Go library ([#111](https://github.com/autobrr/mkbrr/pull/111)) (@s0up4200)
### Other work
* [0d5983d](https://github.com/autobrr/mkbrr/commit/0d5983d1e2c668556b1d9103c17fbf194069fbf8): Bump the github group across 1 directory with 2 updates ([#106](https://github.com/autobrr/mkbrr/pull/106)) (@dependabot\[bot])
**Full Changelog**: [v1.15.0...v1.16.0](https://github.com/autobrr/mkbrr/compare/v1.15.0...v1.16.0)
### Contributors
* @dependabot\[bot]
* @fabricionaweb
* @s0up4200
### New Features
* [448873b](https://github.com/autobrr/mkbrr/commit/448873b3e028227205f4bfd9162b14726543ad02): Add -q shortcut and --info-only flag ([#102](https://github.com/autobrr/mkbrr/pull/102)) (@s0up4200)
**Full Changelog**: [v1.14.0...v1.15.0](https://github.com/autobrr/mkbrr/compare/v1.14.0...v1.15.0)
### Contributors
* @s0up4200
### New Features
* [a737bdc](https://github.com/autobrr/mkbrr/commit/a737bdc86c7167358422ad4de1a7bf247afef90a): Add multiple tracker support to create command ([#99](https://github.com/autobrr/mkbrr/pull/99)) (@s0up4200)
### Bug fixes
* [15e50d1](https://github.com/autobrr/mkbrr/commit/15e50d183e5e76f3dc33a2867d589b9746806d49): Season pack detection for single episodes and file tree display ([#100](https://github.com/autobrr/mkbrr/pull/100)) (@s0up4200)
**Full Changelog**: [v1.13.1...v1.14.0](https://github.com/autobrr/mkbrr/compare/v1.13.1...v1.14.0)
### Contributors
* @s0up4200
### Bug fixes
* [f8c455c](https://github.com/autobrr/mkbrr/commit/f8c455cc33735e4b5d33a9a6f0807c22cc86194a): Accurate duration display without rounding ([#96](https://github.com/autobrr/mkbrr/pull/96)) (@s0up4200)
**Full Changelog**: [v1.13.0...v1.13.1](https://github.com/autobrr/mkbrr/compare/v1.13.0...v1.13.1)
### Contributors
* @s0up4200
### New Features
* [a4e362f](https://github.com/autobrr/mkbrr/commit/a4e362f1ce1558d67987ba54a01ae527d18fe858): Add fail-on-season-warning flag ([#94](https://github.com/autobrr/mkbrr/pull/94)) (@s0up4200)
**Full Changelog**: [v1.12.1...v1.13.0](https://github.com/autobrr/mkbrr/compare/v1.12.1...v1.13.0)
### Contributors
* @s0up4200
### Bug fixes
* [fb4f8b9](https://github.com/autobrr/mkbrr/commit/fb4f8b9c54702e5e2b68a193363a18df8a47f36c): Multiple trackers cannot be added ([#93](https://github.com/autobrr/mkbrr/pull/93)) (@luckylittle)
**Full Changelog**: [v1.12.0...v1.12.1](https://github.com/autobrr/mkbrr/compare/v1.12.0...v1.12.1)
### Contributors
* @luckylittle
### New Features
* [ebc5e05](https://github.com/autobrr/mkbrr/commit/ebc5e054cfd76fb87075c315206ff2c6971cd4a7): Add AlphaRatio ([#90](https://github.com/autobrr/mkbrr/pull/90)) (@s0up4200)
* [18b5884](https://github.com/autobrr/mkbrr/commit/18b58846c7d408a291efa85e2c52c0f4cba644c2): Add output directory support to preset ([#91](https://github.com/autobrr/mkbrr/pull/91)) (@s0up4200)
### Other work
* [2dcfdbe](https://github.com/autobrr/mkbrr/commit/2dcfdbe5b542d722f8d52f184edaa5ab6e2c52aa): Upgrade Go to v1.24 ([#88](https://github.com/autobrr/mkbrr/pull/88)) (@s0up4200)
**Full Changelog**: [v1.11.0...v1.12.0](https://github.com/autobrr/mkbrr/compare/v1.11.0...v1.12.0)
### Contributors
* @s0up4200
### New Features
* [4fc96e4](https://github.com/autobrr/mkbrr/commit/4fc96e41b0b8d8147e8864b5b76232582e672063): Add --output-dir flag ([#86](https://github.com/autobrr/mkbrr/pull/86)) (@s0up4200)
* [bed4819](https://github.com/autobrr/mkbrr/commit/bed4819b76e4898f43de149d9bb29867dbd19e90): Use metadata title for output name ([#87](https://github.com/autobrr/mkbrr/pull/87)) (@s0up4200)
* [c790990](https://github.com/autobrr/mkbrr/commit/c7909904f7669451cbc7ac001f6d7e19e67c0141): Add Docker builds ([#85](https://github.com/autobrr/mkbrr/pull/85)) (@s0up4200)
### Other work
* [53516c1](https://github.com/autobrr/mkbrr/commit/53516c1be81eaacb2f40752febfe5ad42548c0e0): Bump github.com/creativeprojects/go-selfupdate ([#83](https://github.com/autobrr/mkbrr/pull/83)) (@dependabot\[bot])
**Full Changelog**: [v1.10.0...v1.11.0](https://github.com/autobrr/mkbrr/compare/v1.10.0...v1.11.0)
### Contributors
* @dependabot\[bot]
* @s0up4200
### New Features
* [1683103](https://github.com/autobrr/mkbrr/commit/1683103d0b72e207b1194c34c70100d47bc32bda): Add workers flag ([#74](https://github.com/autobrr/mkbrr/pull/74)) (@s0up4200)
* [9a5a850](https://github.com/autobrr/mkbrr/commit/9a5a850f4d0f5985ba4c5444025b0ffa9d4bc668): Add default source setting ([#82](https://github.com/autobrr/mkbrr/pull/82)) (@s0up4200)
### Bug fixes
* [b73489e](https://github.com/autobrr/mkbrr/commit/b73489e60e9ac25d89bd88e2f3c29e6cc29bd287): Prevent filename collisions ([#76](https://github.com/autobrr/mkbrr/pull/76)) (@s0up4200)
* [12e674b](https://github.com/autobrr/mkbrr/commit/12e674b4a9adbc67208dae4437413685ae72a99a): Remove unnecessary season pack suspicion check ([#80](https://github.com/autobrr/mkbrr/pull/80)) (@s0up4200)
### Other work
* [a9be98f](https://github.com/autobrr/mkbrr/commit/a9be98f801e0db0e858f3f27e05a0db492983984): Update documentation ([#75](https://github.com/autobrr/mkbrr/pull/75)) (@s0up4200)
* [51fbe55](https://github.com/autobrr/mkbrr/commit/51fbe55b880c6e31e8ee8ebb2b4c6a610e722cee): Other(makefile): add PGO installation target (@s0up4200)
* [ac76819](https://github.com/autobrr/mkbrr/commit/ac7681960f1b9225c37a014c401454d6707c850e): Helper functions and structs ([#77](https://github.com/autobrr/mkbrr/pull/77)) (@s0up4200)
**Full Changelog**: [v1.9.0...v1.10.0](https://github.com/autobrr/mkbrr/compare/v1.9.0...v1.10.0)
### Contributors
* @s0up4200
### New Features
* [f932554](https://github.com/autobrr/mkbrr/commit/f932554137aa29a033b8765ccee98d601f4cfe00): Struct alignment with betteralign ([#69](https://github.com/autobrr/mkbrr/pull/69)) (@s0up4200)
* [4333558](https://github.com/autobrr/mkbrr/commit/4333558493f88bb575ef21763663691167d58c1a): Add zone.identifier to patterns ([#70](https://github.com/autobrr/mkbrr/pull/70)) (@s0up4200)
* [fb9a2c4](https://github.com/autobrr/mkbrr/commit/fb9a2c484681589930ea26d678b918011e2288d6): Add seedpool ([#71](https://github.com/autobrr/mkbrr/pull/71)) (@s0up4200)
* [788fff5](https://github.com/autobrr/mkbrr/commit/788fff5e755eaa12c6812f0322aac7ebcecb8237): Support entropy flag in presets ([#72](https://github.com/autobrr/mkbrr/pull/72)) (@s0up4200)
### Bug fixes
* [301128b](https://github.com/autobrr/mkbrr/commit/301128b112cbe3d84420588aae8f9513d7db26d8): Entropy flag when not using preset ([#73](https://github.com/autobrr/mkbrr/pull/73)) (@s0up4200)
* [7ed87de](https://github.com/autobrr/mkbrr/commit/7ed87deeaa480456f35713d9db6af60e25ad6730): Only display file tree if verbose (@s0up4200)
* [ba56ae3](https://github.com/autobrr/mkbrr/commit/ba56ae3dc9eae1bae956316b1eefbff7a8c19ebc): Suppress files when over limit (@s0up4200)
* [217f128](https://github.com/autobrr/mkbrr/commit/217f1286e4e0043f71afd7be967ce3a8f0cdf004): Show top directory for file listings (@s0up4200)
### Other work
* [8dbb299](https://github.com/autobrr/mkbrr/commit/8dbb299ce65841c1cfb1e7c53919e29c31144757): Set file tree to verbose only ([#68](https://github.com/autobrr/mkbrr/pull/68)) (@s0up4200)
**Full Changelog**: [v1.8.1...v1.9.0](https://github.com/autobrr/mkbrr/compare/v1.8.1...v1.9.0)
### Contributors
* @s0up4200
### Bug fixes
* [595c76d](https://github.com/autobrr/mkbrr/commit/595c76dc2661f8fe00434c462c8218ad47263335): Recalculate file offsets after sorting ([#65](https://github.com/autobrr/mkbrr/pull/65)) (@s0up4200)
* [3eb2bb7](https://github.com/autobrr/mkbrr/commit/3eb2bb7de879602c07287341b004f673fff7b8bb): Handle symlinks during creation ([#66](https://github.com/autobrr/mkbrr/pull/66)) (@s0up4200)
**Full Changelog**: [v1.8.0...v1.8.1](https://github.com/autobrr/mkbrr/compare/v1.8.0...v1.8.1)
### Contributors
* @s0up4200
### New Features
* [3b46cde](https://github.com/autobrr/mkbrr/commit/3b46cde083824242ad73c3d3d84eb1f04a575525): Add check command ([#58](https://github.com/autobrr/mkbrr/pull/58)) (@s0up4200)
### Bug fixes
* [0427550](https://github.com/autobrr/mkbrr/commit/04275509a2a9a76421866f852d25a8231bf987ee): Correct multi-episode season pack detection ([#56](https://github.com/autobrr/mkbrr/pull/56)) (@s0up4200)
* [505feed](https://github.com/autobrr/mkbrr/commit/505feed2f6046a4427c388e0e0a43f759afa5c2c): Handle filepath.Match errors ([#57](https://github.com/autobrr/mkbrr/pull/57)) (@s0up4200)
### Other work
* [4d6b8f7](https://github.com/autobrr/mkbrr/commit/4d6b8f76fe6b60e5b51badea32e4f2f5451bb7d6): Setup goreleaser-pro ([#54](https://github.com/autobrr/mkbrr/pull/54)) (@s0up4200)
* [1f78ae4](https://github.com/autobrr/mkbrr/commit/1f78ae4531ae68ccdb3ba5453e019829c909d4c0): Revert "build: setup goreleaser-pro" (#61) ([#54](https://github.com/autobrr/mkbrr/pull/54)) (@s0up4200)
**Full Changelog**: [v1.7.0...v1.8.0](https://github.com/autobrr/mkbrr/compare/v1.7.0...v1.8.0)
### Contributors
* @s0up4200
### New Features
* [cc43305](https://github.com/autobrr/mkbrr/commit/cc43305): Support include patterns ([#51](https://github.com/autobrr/mkbrr/pull/51)) (@s0up4200)
### Other work
* [964c41c](https://github.com/autobrr/mkbrr/commit/964c41c): Update README.md ([#49](https://github.com/autobrr/mkbrr/pull/49)) (@s0up4200)
* [cc4f0ee](https://github.com/autobrr/mkbrr/commit/cc4f0ee): Add benchmarks to readme ([#52](https://github.com/autobrr/mkbrr/pull/52)) (@s0up4200)
**Full Changelog**: [v1.6.1...v1.7.0](https://github.com/autobrr/mkbrr/compare/v1.6.1...v1.7.0)
### Contributors
* @s0up4200
### Bug fixes
* [cba577a](https://github.com/autobrr/mkbrr/commit/cba577a): Fix update: replace selfupdater lib with fork ([#48](https://github.com/autobrr/mkbrr/pull/48)) (@s0up4200)
**Full Changelog**: [v1.6.0...v1.6.1](https://github.com/autobrr/mkbrr/compare/v1.6.0...v1.6.1)
### Contributors
* @s0up4200
### New Features
* [1ee35d9](https://github.com/autobrr/mkbrr/commit/1ee35d9): Add skip-prefix flag ([#43](https://github.com/autobrr/mkbrr/pull/43)) (@s0up4200)
* [b1d16e6](https://github.com/autobrr/mkbrr/commit/b1d16e6): Support explicit tracker selection ([#47](https://github.com/autobrr/mkbrr/pull/47)) (@s0up4200)
**Full Changelog**: [v1.3.0...v1.6.0](https://github.com/autobrr/mkbrr/compare/v1.3.0...v1.6.0)
### Contributors
* @s0up4200
### New Features
* [534c9f1](https://github.com/autobrr/mkbrr/commit/534c9f1): Use tracker domain as prefix ([#30](https://github.com/autobrr/mkbrr/pull/30)) (@s0up4200)
* [1e6d445](https://github.com/autobrr/mkbrr/commit/1e6d445): Add torrent-syndikat tracker ([#28](https://github.com/autobrr/mkbrr/pull/28)) (@s0up4200)
* [ba506ba](https://github.com/autobrr/mkbrr/commit/ba506ba): Add incomplete season pack detection ([#29](https://github.com/autobrr/mkbrr/pull/29)) (@s0up4200)
### Other work
* [72bf690](https://github.com/autobrr/mkbrr/commit/72bf690): Improve readme ([#31](https://github.com/autobrr/mkbrr/pull/31)) (@s0up4200)
**Full Changelog**: [v1.2.0...v1.3.0](https://github.com/autobrr/mkbrr/compare/v1.2.0...v1.3.0)
### Contributors
* @s0up4200
### New Features
* [2675b8f](https://github.com/autobrr/mkbrr/commit/2675b8f): Add Homebrew formula ([#16](https://github.com/autobrr/mkbrr/pull/16)) (@s0up4200)
* [726fc73](https://github.com/autobrr/mkbrr/commit/726fc73): Add v flag for extra metadata ([#18](https://github.com/autobrr/mkbrr/pull/18)) (@s0up4200)
* [12d2392](https://github.com/autobrr/mkbrr/commit/12d2392): Add limits per tracker ([#17](https://github.com/autobrr/mkbrr/pull/17)) (@s0up4200)
* [f89a5a1](https://github.com/autobrr/mkbrr/commit/f89a5a1): Optimize piece hashing and buffer management ([#20](https://github.com/autobrr/mkbrr/pull/20)) (@s0up4200)
### Bug fixes
* [753a3e8](https://github.com/autobrr/mkbrr/commit/753a3e8): Add option to omit creator string in torrent file ([#24](https://github.com/autobrr/mkbrr/pull/24)) (@s0up4200)
### Other work
* [df97a71](https://github.com/autobrr/mkbrr/commit/df97a71): Implement PGO ([#21](https://github.com/autobrr/mkbrr/pull/21)) (@s0up4200)
* [2562cf5](https://github.com/autobrr/mkbrr/commit/2562cf5): Bump the golang group with 2 updates ([#25](https://github.com/autobrr/mkbrr/pull/25)) (@dependabot\[bot])
**Full Changelog**: [v1.1.0...v1.2.0](https://github.com/autobrr/mkbrr/compare/v1.1.0...v1.2.0)
### Contributors
* @s0up4200
* @dependabot
### New Features
* [5915059](https://github.com/autobrr/mkbrr/commit/5915059): Add modify command ([#12](https://github.com/autobrr/mkbrr/pull/12)) (@s0up4200)
* [722220b](https://github.com/autobrr/mkbrr/commit/722220b): Add self-update command ([#11](https://github.com/autobrr/mkbrr/pull/11)) (@zze0s)
* [f982c4e](https://github.com/autobrr/mkbrr/commit/f982c4e): Add max\_piece\_length flag ([#8](https://github.com/autobrr/mkbrr/pull/8)) (@martylukyy)
### Bug fixes
* [5d70d7e](https://github.com/autobrr/mkbrr/commit/5d70d7e): Disable cgo for build process ([#14](https://github.com/autobrr/mkbrr/pull/14)) (@s0up4200)
* [ecfc1dd](https://github.com/autobrr/mkbrr/commit/ecfc1dd): Silence help text after error ([#9](https://github.com/autobrr/mkbrr/pull/9)) (@martylukyy)
### Other work
* [cf059cb](https://github.com/autobrr/mkbrr/commit/cf059cb): Display sizes in IEC units ([#7](https://github.com/autobrr/mkbrr/pull/7)) (@martylukyy)
* [6f08a62](https://github.com/autobrr/mkbrr/commit/6f08a62): Skip heavy file tests on Windows to improve CI speed ([#15](https://github.com/autobrr/mkbrr/pull/15)) (@s0up4200)
**Full Changelog**: [v1.0.0...v1.1.0](https://github.com/autobrr/mkbrr/compare/v1.0.0...v1.1.0)
### Contributors
* @s0up4200
* @martylukyy
* @zze0s
### Bug fixes
* [4db1876](https://github.com/autobrr/mkbrr/commit/4db1876): Improve install target (@s0up4200)
### Other work
* [777aabf](https://github.com/autobrr/mkbrr/commit/777aabf): Update preset examples (@s0up4200)
**Full Changelog**: [v0.2.0...v1.0.0](https://github.com/autobrr/mkbrr/compare/v0.2.0...v1.0.0)
### Contributors
* @s0up4200
### New Features
* [43994e1](https://github.com/autobrr/mkbrr/commit/43994e1): Improve output duration ([#4](https://github.com/autobrr/mkbrr/pull/4)) (@s0up4200)
* [39b80ac](https://github.com/autobrr/mkbrr/commit/39b80ac): Add preset support ([#6](https://github.com/autobrr/mkbrr/pull/6)) (@s0up4200)
* [57de4e3](https://github.com/autobrr/mkbrr/commit/57de4e3): Batch processing ([#3](https://github.com/autobrr/mkbrr/pull/3)) (@s0up4200)
### Bug fixes
* [88c2f04](https://github.com/autobrr/mkbrr/commit/88c2f04): Remove name option ([#5](https://github.com/autobrr/mkbrr/pull/5)) (@s0up4200)
### Other work
* [4696484](https://github.com/autobrr/mkbrr/commit/4696484): Update readme (@s0up4200)
* [12ef3cd](https://github.com/autobrr/mkbrr/commit/12ef3cd): Readme cleanup (@s0up4200)
* [e234434](https://github.com/autobrr/mkbrr/commit/e234434): Update readme (@s0up4200)
**Full Changelog**: [v0.1.0...v0.2.0](https://github.com/autobrr/mkbrr/compare/v0.1.0...v0.2.0)
### Contributors
* @s0up4200
# check
Source: https://mkbrr.com/cli-reference/check
Verify the integrity of content against a torrent file.
## Usage
```bash theme={null}
mkbrr check [flags]
```
## Arguments
* ``: Path to the `.torrent` file. (Required)
* ``: Path to the directory or file containing the data to check. (Required)
## Flags
Be verbose.
When enabled, shows detailed information about the verification process including any bad piece indices.
Enable quiet mode, printing only the completion percentage. Useful for scripts.
Useful for automated scripts or when you only need the verification status.
Manually specify the number of concurrent goroutines used for hashing.
Experimenting with different worker values *might* yield better performance than the default automatic setting.
## Examples
### Basic Check
Verify the content in `my_download_folder` against `my_torrent.torrent`:
### Verbose Check
Verify content and show indices of any bad pieces:
### Quiet Check
# create
Source: https://mkbrr.com/cli-reference/create
Create a new torrent file from a file or directory.
## Usage
```bash theme={null}
mkbrr create /path/to/content [flags]
```
Create torrents in two modes:
* Single file/directory mode (default)
* [Batch mode](/features/batch-mode) using a YAML config file
Common settings can be saved and reused with [presets](/features/presets).
By default, when a tracker URL is provided, the output filename will be prefixed with the tracker domain (e.g. "example\_filename.torrent"). Use `--skip-prefix` to disable this behavior.
## Arguments
* `/path/to/content`: (Required unless using `-b`) The path to the source file or directory.
## Flags
### Input & Output
Tracker URL. Can be specified multiple times to add several trackers. Optional.
Set torrent name (default: source filename).
Optional. Set output path (default: `.torrent` or `_.torrent`).
Output directory for created torrent.
Don't add tracker domain prefix to output filename.
### Advanced Input (Batch & Presets)
Batch config file (YAML). Cannot be used with a path argument. With `-b`, `mkbrr create` accepts only `-v`, `-q`, and `-i`. Each job takes its settings from the batch file.
For creating multiple torrents in one go. See the [Batch Mode](/features/batch-mode) documentation for details.
Use preset from config.
For reusing common settings across torrents. See the [Presets](/features/presets) documentation for details.
Preset config file (default `~/.config/mkbrr/presets.yaml`).
Set custom path to presets.yaml. See the [Presets](/features/presets) documentation for details.
### Content Selection
Exclude files matching these patterns (e.g., `"*.nfo,*.jpg"` or `--exclude "*.nfo" --exclude "*.jpg"`).
Use this to filter out unwanted files like NFOs, samples, or extras that shouldn't be in the torrent. See the [filtering guide](/features/filtering) for detailed pattern rules and examples.
Include only files matching these patterns (e.g., `"*.mkv,*.mp4"` or `--include "*.mkv" --include "*.mp4"`).
Using include patterns activates whitelist mode. See the [filtering guide](/features/filtering) for detailed pattern rules and examples.
### Torrent Internals
Make torrent private.
Private flag is enabled by default for tracker compliance. Only disable if you're creating a public torrent.
Set piece length to 2^n bytes (16-27, or 14-27 for a tracker with its own piece size table; automatic if not specified).
Let mkbrr automatically calculate the piece size unless you have specific requirements. The automatic calculation optimizes for both performance and compatibility.
Limit maximum automatically calculated piece length to 2^n bytes (16-27, or 14-27 for a tracker with its own piece size table when target piece count is not set; lower if the tracker has a cap).
Target approximate number of pieces. Calculates optimal piece length automatically.
Mutually exclusive with `--piece-length`.
Randomize the torrent's info hash by adding or updating a unique, random `entropy` key in the info dictionary before hashing.
Cross-seeding is the practice of seeding the same content on multiple trackers. Using the entropy flag helps avoid conflicts between trackers.
### Seeding & Metadata
Specify web seed URLs. Can be used multiple times.
Web seeds provide an HTTP fallback source for the torrent content, improving availability.
Specify the source string.
Some trackers require or recommend specific source tags. Check your tracker's rules.
Specify a comment.
Omit the creation date from the torrent metadata.
Omit the creator string from the torrent metadata.
### Season Pack Detection
Exit with error if season pack completeness check detects missing episodes.
### Execution & Output Control
Plan torrent creation without hashing content or writing a torrent file. The command walks and filters the input exactly like a real create, chooses the final piece length, applies tracker size limits, and prints one JSON object to stdout. Cannot be used with `--batch`.
The JSON object contains:
* `content_size`: total selected content size in bytes
* `piece_length_exponent`: chosen piece length exponent
* `piece_length_bytes`: chosen piece length in bytes
* `predicted_torrent_size`: exact predicted encoded torrent size in bytes
* `tracker_size_limit`: tracker torrent-size limit in bytes, or `0` when none applies
* `notices`: piece-size selection notices generated by the create pipeline
Manually specify the number of concurrent goroutines used for hashing.
Experimenting with different worker values *might* yield better performance than the default automatic setting.
Be verbose.
Enable quiet mode. mkbrr prints only the path of each torrent file that it writes, and writes errors to stderr. Use it in scripts.
Display only torrent info without progress (implies verbose).
# inspect
Source: https://mkbrr.com/cli-reference/inspect
Inspect a torrent file and display its metadata and file structure.
## Usage
```bash theme={null}
mkbrr inspect [flags]
```
## Arguments
* ``: (Required) Path to the `.torrent` file to inspect.
## Flags
Show all metadata fields, including non-standard ones.
# CLI Reference
Source: https://mkbrr.com/cli-reference/introduction
Overview of mkbrr command-line interface commands.
Available commands:
* `create`: Create a new torrent file.
* `check`: Verify the integrity of content against a torrent file.
* `inspect`: Inspect the metadata of a torrent file.
* `modify`: Modify an existing torrent file.
* `update`: Update mkbrr to the latest version.
* `version`: Show the current version of mkbrr.
# modify
Source: https://mkbrr.com/cli-reference/modify
Modify existing torrent files using a preset or flags.
## Usage
```bash theme={null}
mkbrr modify [flags] [torrent files...]
```
`modify` changes only the fields that you set. It keeps the other keys in the info dictionary, including custom keys. It drops unknown top-level keys, which are keys outside the info dictionary that mkbrr does not know. When `modify` changes something, it sets the creation date to now, unless you remove the date with `--no-date` or a preset. If no value changes, `modify` writes no file and prints "no changes needed". A value that the torrent already has is not a change. `--dry-run` uses the same rule.
## Arguments
* `[torrent files...]`: (Required) One or more paths to the `.torrent` files to modify.
## Flags
### Input & Output
Tracker URLs (can be specified multiple times).
Set the torrent's internal name.
Output directory for modified files.
Custom output filename (without extension).
When modifying multiple torrents, using `--output` with a fixed filename will cause subsequent files to overwrite the previous ones. Use `--output-dir` instead for batch modifications to preserve all modified files with unique names.
### Advanced Input (Presets)
Use preset from config.
For reusing common settings across torrents. See the [Presets](/features/presets) documentation for details.
Preset config file (default `~/.config/mkbrr/presets.yaml`).
Set custom path to presets.yaml. See the [Presets](/features/presets) documentation for details.
### Torrent Internals
Make torrent private.
Private flag is enabled by default for tracker compliance. Only disable if you're creating a public torrent.
Remove the private flag entirely.
Randomize the torrent's info hash by adding or updating a unique, random `entropy` key in the info dictionary before hashing.
Cross-seeding is the practice of seeding the same content on multiple trackers. Using the entropy flag helps avoid conflicts between trackers.
Remove the `entropy` key from the info dictionary. The info hash changes. If the torrent has no `entropy` key, mkbrr does not change the file. You cannot use this flag together with `--entropy`.
### Seeding & Metadata
Specify web seed URLs. Can be used multiple times.
Web seeds provide an HTTP fallback source for the torrent content, improving availability.
Specify the source string.
Some trackers require or recommend specific source tags. Check your tracker's rules.
Specify a comment.
Omit the creation date from the torrent metadata.
If you do not use this flag, `modify` sets the creation date to the current time only when another field changes.
Omit the creator string from the torrent metadata.
### Execution & Output Control
Be verbose.
Enable quiet mode. mkbrr prints only the path of each torrent file that it writes, and writes errors to stderr. Use it in scripts.
Leave out the filename prefix from the output filename. The filename prefix is the preset name when you give a preset. Otherwise, it is the domain of the first `--tracker` URL, or `modified` when you give no `--tracker`. A preset `skip_prefix: true` also leaves it out.
Show what would be modified without making changes.
When modifying multiple torrents, using `--output` with a fixed filename will cause subsequent files to overwrite the previous ones. Use `--output-dir` instead for batch modifications to preserve all modified files with unique names.
# update
Source: https://mkbrr.com/cli-reference/update
Update mkbrr to the latest version from GitHub.
## Usage
```bash theme={null}
mkbrr update
```
## Flags
This command has no flags.
# version
Source: https://mkbrr.com/cli-reference/version
Prints the version and build time information for mkbrr.
## Usage
```bash theme={null}
mkbrr version
```
## Flags
This command has no flags.
# Development & Contribution
Source: https://mkbrr.com/development
Information on building mkbrr from source, running tests, and contributing.
## Prerequisites
Before you begin, ensure you have the following installed on your system:
Install Go version 1.27.0 or higher
```bash macOS theme={null}
brew install go
```
```bash Linux (apt) theme={null}
sudo apt install golang
```
```bash Windows theme={null}
choco install golang
```
Verify installation:
```bash theme={null}
go version
```
Required for version control and building from source
```bash macOS theme={null}
brew install git
```
```bash Linux (apt) theme={null}
sudo apt install git
```
```bash Windows theme={null}
choco install git
```
Required for running build commands
```bash macOS theme={null}
# Included with Xcode Command Line Tools
xcode-select --install
```
```bash Linux (apt) theme={null}
sudo apt install make
```
```bash Windows theme={null}
choco install make
```
For other package managers or installation methods, please refer to the official documentation:
* [Go Installation Guide](https://golang.org/doc/install)
* [Git Installation Guide](https://git-scm.com/downloads)
* [Make Installation Guide](https://www.gnu.org/software/make/)
## Building from Source
1. **Clone Repository**
```bash theme={null}
git clone https://github.com/autobrr/mkbrr.git
```
2. **Change Directory**
```bash theme={null}
cd mkbrr
```
3. **Build Binary**
```bash theme={null}
make build
```
The binary will be created in the `build/` directory with version information from git tags
## Development Commands
### Build Commands
```bash theme={null}
make build # Build the binary
make clean # Remove build artifacts
make all # Clean, build, and install the binary
make install # Install the binary in GOPATH
```
### PGO (Profile-Guided Optimization)
```bash theme={null}
make profile # Generate a PGO profile (run before build-pgo)
make build-pgo # Build the binary with PGO optimization
make install-pgo # Install the PGO-optimized binary
```
### GUI Commands
```bash theme={null}
make install-wails # Install the Wails CLI (one-time requirement)
make gui-dev # Run the GUI in development mode
make gui-build # Build the GUI for the current platform
make gui-build-all # Build the GUI for all platforms
make gui-clean # Clean GUI build artifacts
```
### Testing Commands
```bash theme={null}
make test # Run tests (excluding large tests)
make test-race # Run all tests with race detector
make test-race-short # Run quick tests with race detector
make test-large # Run large tests (resource intensive)
make test-coverage # Run tests with coverage report
```
### Quality Tools
```bash theme={null}
make lint # Run golangci-lint
```
Run `make help` to see all available commands and their descriptions
## Contributing
Thanks for taking interest in contributing! We welcome anyone who wants to contribute. If you have an idea for a bigger feature or a change, please discuss it first by opening an issue or joining our [Discord](https://discord.gg/WQ2eUycxyT).
The code and this documentation are in the [mkbrr repository](https://github.com/autobrr/mkbrr). The documentation is in `documentation/`. Open pull requests against the `develop` branch.
* New features and improvements
* Bug fixes and reports
* Documentation updates
* Community support
1. Fork the [mkbrr repository](https://github.com/autobrr/mkbrr/fork)
2. Clone your fork: `git clone https://github.com/YOURNAME/mkbrr.git`
3. Create a feature branch: `git checkout -b feat/your-feature`
4. Make your changes following our guidelines
* Reference related issues
* Mark as Draft if work in progress
* Keep changes focused and atomic
* Be responsive to review feedback
### Commit Guidelines
We follow [Conventional Commit Guidelines](https://www.conventionalcommits.org/en/v1.0.0/#summary):
* `feat(core): add new torrent validation`
* `fix(filter): correct pattern matching`
* `docs(api): update endpoint documentation`
No need for force pushing or rebasing - we squash commits on merge.
### Code Style
* Try to follow Go best practices and idioms
* Use meaningful variable and function names
* Add comments for complex logic
* Keep functions focused and concise
* Run `go fmt` or `gofumpt` before committing
## License
mkbrr is licensed under the **GNU General Public License v2.0**.
See the [LICENSE](https://github.com/autobrr/mkbrr/blob/main/LICENSE) file for full details.
# Batch mode
Source: https://mkbrr.com/features/batch-mode
Batch mode allows you to create multiple torrents from different source paths with varying settings in a single command execution.
Batch mode is ideal for creating multiple torrents in one go.
## Configuration File (`batch.yaml`)
Batch operations are defined in a YAML file, typically named `batch.yaml`.
```bash Command theme={null}
mkbrr create -b /path/to/your/batch.yaml
```
```yaml Example batch.yaml theme={null}
# yaml-language-server: $schema=https://raw.githubusercontent.com/autobrr/mkbrr/main/schema/batch.json
version: 1
jobs:
- output: /torrents/movie1.torrent
path: /media/movies/movie1.mkv
trackers:
- https://tracker-one.com/announce/abc
private: true
comment: "4K HDR Release"
source: "UHD"
- output: /torrents/movie2.torrent
path: /media/movies/movie2.mkv
trackers:
- https://tracker-one.com/announce/abc
private: true
comment: "1080p Release"
source: "BluRay"
```
While `batch.yaml` is a common convention, you can use any filename. Just be sure to specify it with `-b`.
### Configuration Structure
```yaml theme={null}
version: 1
jobs:
- output: /torrents/movie1.torrent
path: /media/movies/movie1.mkv
trackers:
- https://tracker-one.com/announce/abc
private: true
comment: "4K HDR Release"
source: "UHD"
- output: /torrents/movie2.torrent
path: /media/movies/movie2.mkv
trackers:
- https://tracker-one.com/announce/abc
private: true
comment: "1080p Release"
source: "BluRay"
- output: /torrents/movie3.torrent
path: /media/movies/movie3.mkv
trackers:
- https://tracker-one.com/announce/abc
private: true
comment: "720p Release"
source: "WEB"
```
```yaml theme={null}
version: 1
jobs:
- output: /torrents/show_s01.torrent
path: /media/tv/Show/Season 1/
trackers:
- udp://tracker-two.org:6969/announce
private: true
piece_length: 18 # 256 KiB pieces
comment: "Complete Season 1"
exclude_patterns:
- "*.nfo"
- "*.jpg"
- output: /torrents/show_s02.torrent
path: /media/tv/Show/Season 2/
trackers:
- udp://tracker-two.org:6969/announce
private: true
piece_length: 18
comment: "Complete Season 2"
exclude_patterns:
- "*.nfo"
- "*.jpg"
```
```yaml theme={null}
version: 1
jobs:
- output: /torrents/album.torrent
path: /media/music/Artist/Album/
trackers:
- udp://tracker-three.org:6969/announce
private: false
piece_length: 18
webseeds:
- http://seed.example.com/album/
exclude_patterns:
- "*.log"
- "folder.jpg"
- output: /torrents/game.torrent
path: /media/games/Game.iso
trackers:
- https://tracker-four.com/announce
private: true
piece_length: 22 # 4 MiB pieces
source: "RETAIL"
- output: /torrents/ebook.torrent
path: /media/books/Book.pdf
trackers:
- https://tracker-five.com/announce
private: true
comment: "PDF + Extras"
```
### Configuration Options
* **version**: Must be `1`
* **jobs**: List of torrent creation tasks
* **output**: Path for the `.torrent` file
* **path**: Source file/directory path
* **trackers**: Announce URLs list
* **webseeds**: Web seed URLs list
* **private**: Set to `true` or `false`. The default is `true`.
* **piece\_length**: Piece size exponent
* **max\_piece\_length**: Maximum piece size exponent
* **target\_piece\_count**: Target number of pieces (mutually exclusive with piece\_length)
In mkbrr v1.26.0 and earlier, a job without `private` made a public torrent. Now it makes a private torrent. Set `private: false` to make a public torrent.
* **comment**: Torrent comment string
* **source**: Source tag string. If you do not set it, mkbrr uses the default source of the first tracker, when that tracker has one. Set `source: ""` to add no source.
* **entropy**: Set `true` to randomize info hash for cross-seeding
* **no\_date**: Set `true` to omit creation date
* **no\_creator**: Set `true` to omit the creator string
* **skip\_prefix**: Set `true` to prevent adding tracker domain prefix to output filename
* **fail\_on\_season\_warning**: Set `true` to exit with error on missing episodes in season packs
* **exclude\_patterns**: Glob patterns to exclude files
* **include\_patterns**: Glob patterns to include files
You can find the formal JSON schema for validation [here](https://raw.githubusercontent.com/autobrr/mkbrr/main/schema/batch.json).
## Failed jobs
When a job fails, mkbrr continues with the other jobs. The torrents from the jobs that succeed stay on disk. After all jobs run, mkbrr exits with a non-zero code and prints `N of M batch jobs failed`. A script can use this exit code to find a missing torrent.
With `--quiet`, mkbrr prints each failed job to stderr as `Failed: