ComputerDaddyGuy · ComputerDaddyGuy · Oct 10, 2025 · Oct 10, 2025
diff --git a/README.md b/README.md
@@ -333,13 +333,13 @@ max_depth/
 ```
 
 ## Tree format
-Choose between different tree formats.
+Choose between different built-in tree formats, or create your own.
 The default is `UNICODE_BOX_DRAWING`, supported by all terminals, but you can also switch to use `CLASSIC_ASCII`.
 
 ```java
 // Example: FileTreeFormat.java
 var prettyPrinter = FileTreePrettyPrinter.builder()
-    .customizeOptions(options -> options.withTreeFormat(TreeFormat.CLASSIC_ASCII))
+    .customizeOptions(options -> options.withTreeFormat(TreeFormats.CLASSIC_ASCII))
     .build();
 ```
 
@@ -352,9 +352,6 @@ tree_format/
     `-- subFile_2
 ```
 
-> [!TIP]
-> *Idea for a future version: option to allow usage of custom format*
-
 # Project Information
 
 * See [🆕CHANGELOG.md](CHANGELOG.md) for a list of released versions and detailed changes.

diff --git a/ROADMAP.md b/ROADMAP.md
@@ -4,12 +4,11 @@
 - [x] **Features**
   - [x] Option: filtering
   - [x] Option: ordering
-  - [x] Option: emojis
-  - [x] Option: custom emojis mapping
+  - [x] Option: emojis (+ custom mapping)
   - [x] Option: compact directories display
   - [x] Option: line extension (=additional text after the file name)
   - [x] Option: children limit (static & dynamic)
-  - [x] Option: tree format Unicode box drawing / classic ASCII
+  - [x] Option: tree format (+ custom mapping)
   - [x] Option: max directory depth
 - [x] **Helpers**
   - [x] Path matchers
@@ -29,10 +28,11 @@
   - [x] SonarCloud integration
 - [x] **Workflows**
   - [x] Github actions
-  - [x] Publish on Maven Central!
+  - [x] Publish `0.0.x` alpha on Maven Central!
 
 ## To do
-- [ ] Option: custom tree format
+- [ ] Gather feedback
+- [ ] Publish `0.x.0` beta on Maven Central!
 
 ## Backlog / To analyze / To implement if requested
 - [ ] Rework/fix Github wiki to be up to date

diff --git a/assets/project-structure.png b/assets/project-structure.png
diff --git a/...ple/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/ChildLimitDynamic.java b/...ple/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/ChildLimitDynamic.java
@@ -1,8 +1,8 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter.example;
 
-import io.github.computerdaddyguy.jfiletreeprettyprinter.ChildLimits;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.FileTreePrettyPrinter;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PathMatchers;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.ChildLimits;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PathMatchers;
 
 public class ChildLimitDynamic {
 

diff --git a/...xample/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/FileTreeFormat.java b/...xample/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/FileTreeFormat.java
@@ -1,13 +1,13 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter.example;
 
 import io.github.computerdaddyguy.jfiletreeprettyprinter.FileTreePrettyPrinter;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PrettyPrintOptions.TreeFormat;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.TreeFormats;
 
 public class FileTreeFormat {
 
 	public static void main(String[] args) {
 		var prettyPrinter = FileTreePrettyPrinter.builder()
-			.customizeOptions(options -> options.withTreeFormat(TreeFormat.CLASSIC_ASCII))
+			.customizeOptions(options -> options.withTreeFormat(TreeFormats.CLASSIC_ASCII))
 			.build();
 		var tree = prettyPrinter.prettyPrint("src/example/resources/tree_format");
 		System.out.println(tree);

diff --git a/src/example/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/Filtering.java b/src/example/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/Filtering.java
@@ -1,7 +1,7 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter.example;
 
 import io.github.computerdaddyguy.jfiletreeprettyprinter.FileTreePrettyPrinter;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PathMatchers;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PathMatchers;
 
 public class Filtering {
 

diff --git a/...example/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/LineExtension.java b/...example/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/LineExtension.java
@@ -1,8 +1,8 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter.example;
 
 import io.github.computerdaddyguy.jfiletreeprettyprinter.FileTreePrettyPrinter;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.LineExtensions;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PathMatchers;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.LineExtensions;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PathMatchers;
 import java.nio.file.Path;
 import java.util.function.Function;
 

diff --git a/...mple/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/ProjectStructure.java b/...mple/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/ProjectStructure.java
@@ -1,10 +1,10 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter.example;
 
-import io.github.computerdaddyguy.jfiletreeprettyprinter.ChildLimits;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.FileTreePrettyPrinter;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.LineExtensions;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PathMatchers;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PathSorts;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.ChildLimits;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.LineExtensions;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PathMatchers;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PathSorts;
 import java.nio.file.Path;
 import java.util.Comparator;
 import java.util.function.Function;
@@ -56,9 +56,10 @@ public static void main(String[] args) {
 		 */
 		var childLimitFunction = ChildLimits.builder()
 			// Hide all files under renderer and scanner packages
+			.add(PathMatchers.hasAbsolutePathMatchingGlob("**/io/github/computerdaddyguy/jfiletreeprettyprinter/options"), 0)
 			.add(PathMatchers.hasAbsolutePathMatchingGlob("**/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer"), 0)
 			.add(PathMatchers.hasAbsolutePathMatchingGlob("**/io/github/computerdaddyguy/jfiletreeprettyprinter/scanner"), 0)
-			.add(PathMatchers.hasAbsolutePathMatchingGlob("**/io/github/computerdaddyguy/jfiletreeprettyprinter"), 3)
+			.add(PathMatchers.hasAbsolutePathMatchingGlob("**/io/github/computerdaddyguy/jfiletreeprettyprinter"), 4)
 			.build();
 
 		/*
@@ -113,22 +114,25 @@ public static void main(String[] args) {
 		│  └─ 🖼️ project-structure.png	// This image
 		├─ 📂 src/main/java/
 		│  └─ 📂 io/github/computerdaddyguy/jfiletreeprettyprinter/
+		│     ├─ 📂 options/
+		│     │  └─ ...
 		│     ├─ 📂 renderer/
 		│     │  └─ ...
 		│     ├─ 📂 scanner/
 		│     │  └─ ...
 		│     ├─ ☕ FileTreePrettyPrinter.java	// Main entry point
 		│     └─ ...
-		├─ 🗺️ CHANGELOG.md
-		├─ 📖 CONTRIBUTING.md
-		├─ 📄 LICENSE
-		├─ 📖 README.md		// You're reading at this!
+		├─ 🆕 CHANGELOG.md
+		├─ 🤝 CONTRIBUTING.md
+		├─ ⚖️ LICENSE
+		├─ 📘 README.md		// You're reading at this!
 		├─ 🗺️ ROADMAP.md
 		├─ 🛡️ SECURITY.md
-		├─ 🏗️ pom.xml
-		├─ 📖 release_process.md
+		├─ 🛠️ pom.xml
+		├─ 📝 release_process.md
 		└─ 📜 runMutationTests.sh
 
+
 		 */
 	}
 

diff --git a/src/example/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/Sorting.java b/src/example/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/Sorting.java
@@ -1,7 +1,7 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter.example;
 
 import io.github.computerdaddyguy.jfiletreeprettyprinter.FileTreePrettyPrinter;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PathSorts;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PathSorts;
 
 public class Sorting {
 

diff --git a/src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/FileTreePrettyPrinter.java b/src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/FileTreePrettyPrinter.java
@@ -1,5 +1,6 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter;
 
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PrettyPrintOptions;
 import java.io.UncheckedIOException;
 import java.nio.file.Path;
 import org.jspecify.annotations.NullMarked;

diff --git a/.../java/io/github/computerdaddyguy/jfiletreeprettyprinter/FileTreePrettyPrinterBuilder.java b/.../java/io/github/computerdaddyguy/jfiletreeprettyprinter/FileTreePrettyPrinterBuilder.java
@@ -1,5 +1,6 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter;
 
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PrettyPrintOptions;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.TreeEntryRenderer;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.PathToTreeScanner;
 import java.util.Objects;

diff --git a/...etreeprettyprinter/ChildLimitBuilder.java → ...ttyprinter/options/ChildLimitBuilder.java b/...etreeprettyprinter/ChildLimitBuilder.java → ...ttyprinter/options/ChildLimitBuilder.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import java.nio.file.PathMatcher;

diff --git a/...y/jfiletreeprettyprinter/ChildLimits.java → ...reeprettyprinter/options/ChildLimits.java b/...y/jfiletreeprettyprinter/ChildLimits.java → ...reeprettyprinter/options/ChildLimits.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 /**
  * Utility class providing constants and factory methods for creating

diff --git a/...r/renderer/emoji/DefaultEmojiMapping.java → ...yprinter/options/DefaultEmojiMapping.java b/...r/renderer/emoji/DefaultEmojiMapping.java → ...yprinter/options/DefaultEmojiMapping.java
@@ -1,6 +1,5 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PathMatchers;
 import java.nio.file.Path;
 import java.util.Objects;
 import java.util.Optional;

diff --git a/...rer/emoji/DefaultEmojiMappingBuilder.java → ...r/options/DefaultEmojiMappingBuilder.java b/...rer/emoji/DefaultEmojiMappingBuilder.java → ...r/options/DefaultEmojiMappingBuilder.java
@@ -1,6 +1,6 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
-import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji.PathMatcherEmojiFunction.EmojiMatch;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.options.PathMatcherEmojiFunction.EmojiMatch;
 import java.nio.file.PathMatcher;
 import java.util.ArrayList;
 import java.util.HashMap;

diff --git a/...yprinter/renderer/emoji/EmojiMapping.java → ...eeprettyprinter/options/EmojiMapping.java b/...yprinter/renderer/emoji/EmojiMapping.java → ...eeprettyprinter/options/EmojiMapping.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import org.jspecify.annotations.NullMarked;

diff --git a/...r/renderer/emoji/EmojiMappingBuilder.java → ...yprinter/options/EmojiMappingBuilder.java b/...r/renderer/emoji/EmojiMappingBuilder.java → ...yprinter/options/EmojiMappingBuilder.java
@@ -1,6 +1,5 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
-import io.github.computerdaddyguy.jfiletreeprettyprinter.PathMatchers;
 import java.nio.file.PathMatcher;
 import org.jspecify.annotations.NullMarked;
 

diff --git a/...eeprettyprinter/LineExtensionBuilder.java → ...printer/options/LineExtensionBuilder.java b/...eeprettyprinter/LineExtensionBuilder.java → ...printer/options/LineExtensionBuilder.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import java.nio.file.PathMatcher;

diff --git a/...filetreeprettyprinter/LineExtensions.java → ...prettyprinter/options/LineExtensions.java b/...filetreeprettyprinter/LineExtensions.java → ...prettyprinter/options/LineExtensions.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 /**
  * Utility class providing constants and factory methods for creating

diff --git a/...yprinter/renderer/emoji/MappingUtils.java → ...eeprettyprinter/options/MappingUtils.java b/...yprinter/renderer/emoji/MappingUtils.java → ...eeprettyprinter/options/MappingUtils.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.util.Map;
 import java.util.Map.Entry;

diff --git a/...rer/emoji/PathExtensionEmojiFunction.java → ...r/options/PathExtensionEmojiFunction.java b/...rer/emoji/PathExtensionEmojiFunction.java → ...r/options/PathExtensionEmojiFunction.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import java.util.ArrayList;

diff --git a/...derer/emoji/PathMatcherEmojiFunction.java → ...ter/options/PathMatcherEmojiFunction.java b/...derer/emoji/PathMatcherEmojiFunction.java → ...ter/options/PathMatcherEmojiFunction.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import java.nio.file.PathMatcher;

diff --git a/.../jfiletreeprettyprinter/PathMatchers.java → ...eeprettyprinter/options/PathMatchers.java b/.../jfiletreeprettyprinter/PathMatchers.java → ...eeprettyprinter/options/PathMatchers.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.io.IOException;
 import java.io.UncheckedIOException;

diff --git a/...renderer/emoji/PathNameEmojiFunction.java → ...rinter/options/PathNameEmojiFunction.java b/...renderer/emoji/PathNameEmojiFunction.java → ...rinter/options/PathNameEmojiFunction.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import java.util.Map;

diff --git a/...iletreeprettyprinter/PathSortBuilder.java → ...rettyprinter/options/PathSortBuilder.java b/...iletreeprettyprinter/PathSortBuilder.java → ...rettyprinter/options/PathSortBuilder.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import java.nio.file.PathMatcher;

diff --git a/...guy/jfiletreeprettyprinter/PathSorts.java → ...etreeprettyprinter/options/PathSorts.java b/...guy/jfiletreeprettyprinter/PathSorts.java → ...etreeprettyprinter/options/PathSorts.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import java.util.Comparator;

diff --git a/...treeprettyprinter/PrettyPrintOptions.java → ...typrinter/options/PrettyPrintOptions.java b/...treeprettyprinter/PrettyPrintOptions.java → ...typrinter/options/PrettyPrintOptions.java
@@ -1,7 +1,6 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.RenderingOptions;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji.EmojiMapping;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.ScanningOptions;
 import java.nio.file.Path;
 import java.nio.file.PathMatcher;
@@ -62,21 +61,7 @@ public PrettyPrintOptions withChildLimit(ToIntFunction<Path> childLimitFunction)
 
 	// ---------- Tree format ----------
 
-	public static enum TreeFormat {
-
-		/**
-		 * Uses characters: |--, `-- and │
-		 */
-		CLASSIC_ASCII,
-
-		/**
-		 * Uses characters: ├─, └─ and │
-		 */
-		UNICODE_BOX_DRAWING,
-
-	}
-
-	private TreeFormat treeFormat = TreeFormat.UNICODE_BOX_DRAWING;
+	private TreeFormat treeFormat = TreeFormats.UNICODE_BOX_DRAWING;
 
 	@Override
 	public TreeFormat getTreeFormat() {
@@ -85,7 +70,7 @@ public TreeFormat getTreeFormat() {
 
 	/**
 	 * Sets the depth rendering format.
-	 * Default is {@link TreeFormat#UNICODE_BOX_DRAWING}.
+	 * Default is {@link TreeFormats#UNICODE_BOX_DRAWING}.
 	 * 
 	 * @param treeFormat The format to use, cannot be <code>null</code>.
 	 */

diff --git a/...nderer/emoji/SequentialEmojiFunction.java → ...nter/options/SequentialEmojiFunction.java b/...nderer/emoji/SequentialEmojiFunction.java → ...nter/options/SequentialEmojiFunction.java
@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.options;
 
 import java.nio.file.Path;
 import java.util.Objects;