add --start-priority option

qbitorrent imports these lists with priority reflecting the order
in the input list.

--start-priority 10

will output 10 blank lines to set the tracker prioritys starting at 10

use this to avoid merging newly added tracker priorities with existing ones

Signed-off-by: Fletcher Aksel <[email protected]>

Author: Fletcher Aksel

cmd/groups.go

@@ -20,11 +20,19 @@ var groupsCmd = &cobra.Command{
 	RunE:  runGroups,
 }
 
+var startPriority int
+
 func init() {
 	rootCmd.AddCommand(groupsCmd)
+	groupsCmd.Flags().IntVarP(&startPriority, "start-priority", "p", 0, "Output N blank lines before tracker groups (default: 0)")
 }
 
 func runGroups(cmd *cobra.Command, args []string) error {
+	// Validate start-priority flag
+	if startPriority < 0 {
+		return fmt.Errorf("start-priority must be a non-negative integer, got: %d", startPriority)
+	}
+
 	// Load config
 	cfg, err := config.Load()
 	if err != nil {
@@ -81,10 +89,24 @@ func runGroups(cmd *cobra.Command, args []string) error {
 		}
 	}()
 
+	// Output blank lines for start-priority
+	if err := outputStartPriority(writer, startPriority); err != nil {
+		return err
+	}
+
 	// Output groups
 	return outputGroups(writer, groups)
 }
 
+func outputStartPriority(writer io.Writer, count int) error {
+	for i := 0; i < count; i++ {
+		if _, err := fmt.Fprintln(writer); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
 func outputGroups(writer io.Writer, groups []group.Group) error {
 	for i, g := range groups {
 		if i > 0 {

cmd/root.go

@@ -18,6 +18,7 @@ var outputFile string
 
 func init() {
 	rootCmd.PersistentFlags().StringVarP(&outputFile, "output", "o", "", "Write output to file instead of stdout")
+	rootCmd.Flags().IntVarP(&startPriority, "start-priority", "p", 0, "Output N blank lines before tracker groups (default: 0)")
 }
 
 // Execute runs the root command

prompts/02-start-priority.md

@@ -0,0 +1,40 @@
+## Feature Addition: Start Priority Flag
+
+Add a new flag to the `groups` command that outputs N blank lines before the grouped tracker URLs.
+
+### Flag Specification
+- `--start-priority <number>` or `-p <number>`
+- Takes an integer argument (number of blank lines to output)
+- Only applies to the `groups` command (default command)
+- Works with both stdout and file output (`-o` flag)
+
+### Behavior
+- Output N blank lines at the very beginning, before any tracker groups
+- Then output the normal grouped tracker URLs as usual
+- Example: `gettrackers groups --start-priority 10` outputs 10 blank lines, then the tracker groups
+
+### Use Case
+This creates N "empty groups" that offset the priority of added trackers in clients like qBittorrent, effectively lowering the priority of the new trackers.
+
+### Implementation Notes
+- Validate that the number is non-negative (0 or positive integer)
+- If invalid number provided, show clear error message
+- Default value should be 0 (no blank lines) if flag not specified
+- The blank lines should come before any other output, including the first tracker group
+
+### Example Output
+```
+gettrackers groups -p 3
+```
+
+Would output:
+```
+[blank line]
+[blank line]
+[blank line]
+http://tracker1.example.com:8080/announce
+http://tracker1.example.com:9090/announce
+
+http://api.other.com/tracker
+...
+```