DEV Community: Maksymilian

File Bucketer, a simple CLI tool to organize files into buckets

Maksymilian — Sat, 01 Nov 2025 09:38:44 +0000

Working with large file collections often requires splitting them into smaller chunks. You might be preparing datasets, batching assets for processing, archiving, or migrating data.

File Bucketer is a lightweight command-line tool that automatically distributes files from an input directory into a specified number of buckets, or into buckets with a defined maximum number of files. It supports both copying and moving files.

✨ Features

Automatically splits files from any input directory
Choose either number of buckets or number of files per bucket
Supports copy and move operations
Cross-platform binary (Windows, Linux, macOS)
Informative terminal output with clear progress messages

📦 Installation

Go to the Releases page
Download the .tar or .zip archive containing the binary
Extract it
Run:

Linux/macOS:

./bin/file-bucketer

Windows:

.\bin\file-bucketer.bat

🛠️ Usage

Linux/macOS:

./bin/file-bucketer <parameters>

Windows:

.\bin\file-bucketer.bat <parameters>

Parameters:

Option	Short option	Description	Type	Required
`--input`	`-i`	Input directory	String	yes
`--output`	`-o`	Output directory. May not exist	String	yes
`--buckets`	`-b`	Bucket count. Mutually exclusive with `--count` option. Must be present if `--count` option is not specified	Int	yes/no
`--count`	`-c`	Count per bucket. Mutually exclusive with `--buckets` option. Must be present if `--buckets` option is not specified	Int	yes/no
`--transferOption`	`-t`	Transfer type. Value should be one of `copy`, `move`. Defaults to `copy`	`copy`, `move`	no
`--help`	`-h`	Usage info	-	no

📁 Example

Imagine you want to split the files located in /home/bob/foo into 5 buckets and move them to /home/alice/foo:

./bin/file-bucketer \
  -i /home/bob/foo \
  -o /home/alice/foo \
  -b 5 \
  -t move

Example output:

Got parameters:
    input: '/home/bob/foo'
    output: '/home/alice/foo'
    buckets: '5'
    count: 'calculated'
    transfer option: 'MOVE'
Validating given input directory...
Validate given output directory...
Counting files under the directory...
Found: 10 files.
Preparing 5 buckets with at most 2 elements...
Pouring into the buckets...
Process completed.

Result:

❯ ls /home/alice/foo
bucket_0 bucket_1 bucket_2 bucket_3 bucket_4

🚀 Summary

If you need a straightforward utility to split files without writing your own scripts, File Bucketer provides a simple and efficient solution.

The project is fully open-source and available on Codeberg.
Feedback and contributions are welcome. Happy bucketing!

🎧 Meet VPlayer - A Simple Audio Player with Visualizations (Built by a Python Newbie)

Maksymilian — Thu, 10 Jul 2025 19:04:31 +0000

Hey devs 👋

I'm still pretty new to Python, but I recently challenged myself to rebuild an old Bash script I wrote for playing music… and I ended up with a full terminal media player.

Meet VPlayer a minimal audio player that lets you listen to your favorite tracks with live terminal visualizations. All powered by Python, VLC, and Cava.

🚀 What It Does

Plays audio files using vlc (headless)
Launches cava for cool terminal visualizations
Lightweight and simple
Cross-platform (buildable with PyInstaller)

📦 Try It Out

🔗 GitHub: github.com/maksik997/vplayer

You’ll find:

Installation instructions (build or binary)
Usage examples
Troubleshooting tips

Built for fun and for anyone who misses visual EQs in their terminal ✨

❗ Why?

This started as a simple Bash script…
Now it’s my first real Python project with packaging and cross-platform support.

If you're a Python beginner like me, maybe it’ll inspire you to build something from your own scripts too.

🎶 Check it out, give it a star ⭐, and let me know what you think!

Enjoy your terminal music with VPlayer!

📖 ZomboidBookTracker – Track Your Skill Books in Project Zomboid!

Maksymilian — Sat, 01 Mar 2025 22:33:47 +0000

Are you a Project Zomboid player struggling to keep track of which skill books you've found and read?
Do you want a simple and lightweight tool to manage your book collection efficiently?

Introducing ZomboidBookTracker – a handy application that helps you monitor your reading progress and optimize your character’s skill development!

🎯 What is ZomboidBookTracker?

Project Zomboid features an extensive skill book system that significantly boosts skill progression. However, keeping track of what you've already read can be a hassle—especially in multiplayer games or long playthroughs.

ZomboidBookTracker is a simple and effective tool that allows you to:
✅ Track skill books – Mark books as owned or missing to manage your collection.
✅ Stay organized – Avoid wasting time searching for duplicates.
✅ Work with any game version – The book list is customizable to match updates or mods.
✅ Use it easily – Simple UI, no unnecessary complexity!

🔧 How to Get Started?

🚀 Option 1: Download the Pre-Built JAR

For a quick start, head over to the Releases section and grab the latest .jar file.

Download the ZomboidBookTracker.jar.
Run it by double-clicking the file, or using:

java -jar ZomboidBookTracker.jar

Note: Java 21 or later is required!

🛠 Option 2: Build from Source

If you prefer building it yourself:

Clone the repository:

git clone https://github.com/maksik997/ZomboidBookTracker.git
cd ZomboidBookTracker

Build and run with Maven:

mvn clean javafx:run

Requirements: JDK 21 or later and Maven installed on your system.

🎮 How to Use It?

It’s straightforward—just like the definition of horse in the first Polish dictionary. 🐴

Mark the books you own, track what you've read, and enjoy your zombie survival with a well-planned skill progression!

📜 License

ZomboidBookTracker is released under the MIT License – feel free to use, modify, and contribute!

🤝 Contribute & Support

Want to improve the project? Feel free to fork, contribute, or report issues on GitHub:
👉 GitHub Repository

Got feedback? Drop a comment or reach out—I’d love to hear your thoughts!

💀📚 Survive smarter, read better, and stay ahead of the apocalypse!

Major Release: Total Overhaul - JavaFX Renaissance

Maksymilian — Fri, 27 Dec 2024 18:49:38 +0000

Hey devs! After months of development, I'm thrilled to announce the biggest update yet to my project - PictureComparerFX!

🔥 What's new?

This update is a complete transformation of the application, featuring:

A modern UI powered by JavaFX
Enhanced performance targeting Java 21
New logging & resource management systems for smoother operation
Easy-to-install packages for MacOS and Linux

It's not just an update; it's the foundation for future growth and stability.

🛠️ Key Changes:

New Classes:
- PictureComparerFX, PathResolver, FileSizeComparator, and many more...
- New controllers, models, services...
StateMachine implemented for the Comparer module.
UI fully rebuilt in JavaFX
Build scripts added for Linux and MacOS.

🧹 Refactoring & Cleanup:

AsyncTaskFactory has been reworked into AsyncTaskSupport
Replaced the application thumbnail
Improved documentation (README.md)

💀 Deprecated:

Swing-based UI is gone - RIP 🪦
Old controllers, models, and legacy components have been removed clearing the path for more scalable architecture.

📅 Release Date: 27.12.2024

➡️ How to Upgrade:

To upgrade, follow the instructions here: GitHub Link

💡 Why This Matters:

Switching to JavaFX not only breathes new life into the app but also lays a strong foundation for future development. I wanted to make sure the UI feels modern and snappy, while the backend benefits from improved efficiency and maintainability.

If you're interested in JavaFX, UI rebuilding, or general Java development - this might be worth a look. Feedback is always appreciated!

👉 Check it out on GitHub: PictureComparerFX Repo

"This marks the biggest update yet, redefining the application from the ground up."

Would love to hear your thoughts or experiences with similar overhauls.

Scalable Image Comparison: An Open-Source Java Library

Maksymilian — Tue, 10 Dec 2024 00:29:32 +0000

I’ve been working on an open-source Java library designed for scalable, multi-stage image comparison. It allows you to mix and match strategies (like CRC32 checksum and perceptual hashing) to de-duplicate massive collections efficiently.

The core design is modular, so you can implement your own strategies for both grouping and comparison. For example:

Combine CRC32Grouper + PHash + PixelByPixel to identify duplicates.
Use some kind of meta data Grouper + PerceptualHash to identify similar images.

I’d love to hear your feedback:

Does this approach make sense for large-scale scenarios?
What could I improve to make it more extensible?

Here’s the repository: LINK.

If you have ideas for new features or want to contribute, feel free to open an issue or submit a PR. Any thoughts appreciated!