custom width

Author: Matars

README.md

@@ -1,6 +1,6 @@
 # gitfetch
 
-A neofetch-style CLI tool for GitHub, GitLab, Gitea, Forgejo, Codeberg, and Sourcehut statistics. Display your profile and stats from various git hosting platforms in a beautiful, colorful terminal interface.
+A neofetch-style CLI tool for GitHub, GitLab, Gitea, Forgejo, Codeberg, and Sourcehut statistics. Display your profile and stats from various git hosting platforms in a beautiful, colorful terminal interface with extensive customization options and intelligent layout adaptation.
 
 <img width="3024" height="1964" alt="image" src="https://github.com/user-attachments/assets/bbb18d5d-4787-4998-a352-e8f4e59642c0" />
 
@@ -11,9 +11,10 @@ A neofetch-style CLI tool for GitHub, GitLab, Gitea, Forgejo, Codeberg, and Sour
 - Neofetch-style display with ASCII art
 - Comprehensive statistics from multiple git hosting platforms
 - Smart SQLite-based caching system for faster subsequent runs
-- Persistent configuration with default username support
 - Cross-platform support (macOS and Linux)
 - First-run initialization with interactive provider selection
+- Customize contribution characters, hide/show sections, control display elements
+- Flags for advanced configuration (e.g., `--no-date`, `--graph-only`, `--custom-box`, `--width`, `--height`) see full list below with `gitfetch --help`
 
 ## Supported Platforms
 
@@ -118,6 +119,8 @@ Fetch stats for specific user:
 gitfetch username
 ```
 
+### Cache Options
+
 Bypass cache and fetch fresh data:
 
 ```bash
@@ -130,6 +133,95 @@ Clear cache:
 gitfetch --clear-cache
 ```
 
+### Visual Customization
+
+Customize contribution block characters:
+
+```bash
+gitfetch --custom-box "██"
+gitfetch --custom-box "■"
+gitfetch --custom-box "●"
+```
+
+Set custom graph dimensions:
+
+```bash
+gitfetch --width 50 --height 5  # 50 chars wide, 5 days high
+gitfetch --width 100            # Custom width, default height
+gitfetch --height 3             # Default width, 3 days high
+```
+
+Hide month/date labels:
+
+```bash
+gitfetch --no-date
+```
+
+Show only contribution graph:
+
+```bash
+gitfetch --graph-only
+```
+
+Hide specific sections:
+
+```bash
+gitfetch --no-achievements  # Hide achievements
+gitfetch --no-languages     # Hide languages
+gitfetch --no-issues        # Hide issues section
+gitfetch --no-pr           # Hide pull requests
+gitfetch --no-account      # Hide account info
+gitfetch --no-grid         # Hide contribution grid
+```
+
+Combine multiple options:
+
+```bash
+gitfetch --no-date --no-achievements --custom-box "█" --width 60
+```
+
+### Layout Control
+
+gitfetch automatically adapts to your terminal size, but you can control spacing:
+
+```bash
+gitfetch --spaced     # Enable spaced layout
+gitfetch --not-spaced # Disable spaced layout
+```
+
+### Custom Dimensions and Coloring Accuracy
+
+The coloring system uses GitHub's standard contribution levels, which are absolute thresholds that remain consistent regardless of the time period or dimensions displayed:
+
+- **0 contributions**: Lightest gray
+- **1-2 contributions**: Light green (Level 1)
+- **3-6 contributions**: Medium green (Level 2)
+- **7-12 contributions**: Dark green (Level 3)
+- **13+ contributions**: Darkest green (Level 4)
+
+**What Custom Dimensions Affect:**
+
+- `--width` and `--height` control how many weeks/days are visible
+- The coloring thresholds remain the same (GitHub standard)
+- You see the same accurate representation, just for a different time period
+
+**When It Might Seem "Inaccurate":**
+If you're viewing only recent weeks with generally lower activity, everything might appear in lighter colors. This is actually correct - those weeks truly have fewer contributions compared to your overall history standards.
+
+**Recommendation:** The current coloring is accurate. Custom dimensions don't reduce accuracy - they just show different portions of your accurately-colored contribution history.
+
+## Intelligent Layout System
+
+gitfetch automatically selects the best layout based on your terminal dimensions:
+
+- **Full Layout**: Shows all sections (graph, account info, languages, achievements) when there's sufficient space (width ≥ 120 columns)
+- **Compact Layout**: Shows graph and key info side-by-side for medium terminals
+- **Minimal Layout**: Shows only the contribution graph for narrow terminals
+
+The system considers both terminal width AND height to ensure optimal display. For very short terminals, it may choose more compact layouts even with sufficient width.
+
+You can override automatic layout selection using the `--width` and `--height` flags to set custom graph dimensions, which will force gitfetch to adapt the layout accordingly.
+
 ## Troubleshooting
 
 ### Error: GitHub CLI is not authenticated
@@ -167,12 +259,17 @@ username = yourusername
 cache_expiry_hours = 24
 provider = github
 provider_url = https://api.github.com
+custom_box = ■
 ```
 
 - `username`: Your default username (automatically detected)
 - `cache_expiry_hours`: How long to keep cached data (default: 24 hours)
 - `provider`: Git hosting provider (github, gitlab, gitea, sourcehut)
 - `provider_url`: API URL for the provider
+- `custom_box`: Character used for contribution blocks (default: ■)
+
+**Note**: Custom graph dimensions (`--width`, `--height`) and section visibility flags (`--no-*`) are command-line only and not saved in the configuration file.
+Howerver if there is a need for it to be added to the config file please open an issue.
 
 ### [COLORS] Section
 
@@ -207,10 +304,12 @@ If you have an older version of gitfetch that stored cache in `~/.config/gitfetc
 ```bash
 rm ~/.config/gitfetch/cache.db
 ```
+
 ## Acknowledgements
 
-- Inspired by the beautiful contribution graph design from [Kusa](https://github.com/Ryu0118/Kusa) by Ryu0118.
-- Inspired by the very cool and extremely fun tool [songfetch](https://github.com/fwtwoo/songfetch) by fwtwoo.
+- Inspired by the beautiful contribution graph design from [Kusa](https://github.com/Ryu0118/Kusa) by Ryu0118
+- Inspired by the very cool and extremely fun tool [songfetch](https://github.com/fwtwoo/songfetch) by fwtwoo
+- Built with modern Python practices and extensive customization options for the ultimate git statistics display
 
 ## License
 

src/gitfetch/cli.py

@@ -120,6 +120,18 @@ def parse_args() -> argparse.Namespace:
         help="Hide contribution grid/graph"
     )
 
+    visual_group.add_argument(
+        "--width",
+        type=int,
+        help="Set custom width for contribution graph"
+    )
+
+    visual_group.add_argument(
+        "--height",
+        type=int,
+        help="Set custom height for contribution graph"
+    )
+
     return parser.parse_args()
 
 
@@ -176,7 +188,7 @@ def main() -> int:
                                  args.graph_only, not args.no_achievements,
                                  not args.no_languages, not args.no_issues,
                                  not args.no_pr, not args.no_account,
-                                 not args.no_grid)
+                                 not args.no_grid, args.width, args.height)
     if args.spaced:
         spaced = True
     elif args.not_spaced:

src/gitfetch/display.py

@@ -16,14 +16,16 @@ class DisplayFormatter:
 
     def __init__(self, config_manager: ConfigManager,
                  custom_box: Optional[str] = None,
-                 show_date: bool = True,
+                 show_date: Optional[bool] = None,
                  graph_only: bool = False,
                  show_achievements: bool = True,
                  show_languages: bool = True,
                  show_issues: bool = True,
                  show_pr: bool = True,
                  show_account: bool = True,
-                 show_grid: bool = True):
+                 show_grid: bool = True,
+                 custom_width: Optional[int] = None,
+                 custom_height: Optional[int] = None):
         """Initialize the display formatter."""
         terminal_size = shutil.get_terminal_size()
         self.terminal_width = terminal_size.columns
@@ -33,14 +35,17 @@ def __init__(self, config_manager: ConfigManager,
         self.enable_color = sys.stdout.isatty()
         self.colors = config_manager.get_colors()
         self.custom_box = custom_box or config_manager.get_custom_box() or "■"
-        self.show_date = show_date
+        self.show_date = (show_date if show_date is not None
+                          else config_manager.get_show_date())
         self.graph_only = graph_only
         self.show_achievements = show_achievements
         self.show_languages = show_languages
         self.show_issues = show_issues
         self.show_pr = show_pr
         self.show_account = show_account
         self.show_grid = show_grid
+        self.custom_width = custom_width
+        self.custom_height = custom_height
 
     def display(self, username: str, user_data: Dict[str, Any],
                 stats: Dict[str, Any], spaced=True) -> None:
@@ -96,14 +101,11 @@ def _calculate_minimal_dimensions(self, username: str,
             height = len(header_lines)
             return (width, height)
 
-        contrib_graph = stats.get('contribution_graph', [])
-        graph_lines = self._get_contribution_graph_lines(
-            contrib_graph, username, width_constraint=self.terminal_width - 4,
-            include_sections=False, spaced=True
-        )
-        width = max((self._display_width(line) for line in graph_lines),
-                    default=0)
-        height = len(graph_lines)
+        # Use custom dimensions if provided
+        width = (self.custom_width if self.custom_width is not None
+                 else self.terminal_width - 4)
+        height = (self.custom_height if self.custom_height is not None
+                  else 7)
         return (width, height)
 
     def _calculate_compact_dimensions(self, username: str,
@@ -112,17 +114,20 @@ def _calculate_compact_dimensions(self, username: str,
         """Calculate dimensions for compact layout."""
         contrib_graph = stats.get('contribution_graph', [])
         recent_weeks = self._get_recent_weeks(contrib_graph)
-        graph_width = max(40, (self.terminal_width - 40) // 2)
+        graph_width = (self.custom_width if self.custom_width is not None
+                       else max(40, (self.terminal_width - 40) // 2))
 
         if self.show_grid:
-            graph_lines = self._get_contribution_graph_lines(
-                contrib_graph, username, width_constraint=graph_width,
-                include_sections=False, spaced=True
-            )
+            # Use custom height for graph height
+            graph_height = (self.custom_height if self.custom_height is not None
+                            else 7)
         else:
             # Just header for dimensions
             total_contribs = self._calculate_total_contributions(recent_weeks)
             graph_lines = self._graph_header(username, total_contribs)
+            graph_width = max((self._display_width(line) for line in graph_lines),
+                              default=0)
+            graph_height = len(graph_lines)
 
         right_side = []
         if self.show_account:
@@ -135,7 +140,7 @@ def _calculate_compact_dimensions(self, username: str,
                     right_side.append("")
                 right_side.extend(achievements)
 
-        max_lines = max(len(graph_lines), len(right_side))
+        max_lines = max(graph_height, len(right_side))
         right_width = max((self._display_width(line) for line in right_side),
                           default=0)
         total_width = graph_width + 2 + right_width
@@ -291,30 +296,32 @@ def _display_full(self, username: str, user_data: Dict[str, Any],
             )
 
         # Add PR/issues sections to left side if enabled
-        if self.show_pr or self.show_issues:
-            pull_request_lines = (self._format_pull_requests(stats)
-                                  if self.show_pr else [])
-            issue_lines = (self._format_issues(stats)
-                           if self.show_issues else [])
-
-            # Only show PR/Issue columns if they fit side by side
-            section_columns = []
-            if pull_request_lines and issue_lines:
-                pr_width = max((self._display_width(line)
-                               for line in pull_request_lines), default=0)
-                issue_width = max((self._display_width(line)
-                                  for line in issue_lines), default=0)
-                total_width = pr_width + issue_width + len("   ")  # gap
-                if total_width <= graph_width:
-                    section_columns = [pull_request_lines, issue_lines]
-            # Do not show only one column; only show both if they fit
-            combined_sections = self._combine_section_grid(
-                section_columns, width_limit=graph_width
-            )
-            if combined_sections:
-                if left_side:
-                    left_side.append("")
-                left_side.extend(combined_sections)
+            if self.show_pr or self.show_issues:
+                pull_request_lines = self._format_pull_requests(
+                    stats) if self.show_pr else []
+                issue_lines = self._format_issues(
+                    stats) if self.show_issues else []
+
+                section_columns = []
+                if pull_request_lines and issue_lines:
+                    pr_width = max((self._display_width(line)
+                                   for line in pull_request_lines), default=0)
+                    issue_width = max((self._display_width(line)
+                                      for line in issue_lines), default=0)
+                    total_width = pr_width + issue_width + len("   ")  # gap
+                    if total_width <= graph_width:
+                        section_columns = [pull_request_lines, issue_lines]
+                elif pull_request_lines:
+                    section_columns = [pull_request_lines]
+                elif issue_lines:
+                    section_columns = [issue_lines]
+
+                combined_sections = self._combine_section_grid(
+                    section_columns, width_limit=graph_width)
+                if combined_sections:
+                    if left_side:
+                        left_side.append("")
+                    left_side.extend(combined_sections)
         elif not self.show_grid:
             # If no grid and no PR/issues, show just header
             total_contribs = self._calculate_total_contributions(
@@ -386,18 +393,25 @@ def _get_contribution_graph_lines(self, weeks_data: list,
             return [*header_lines, *self._empty_graph_placeholder()]
 
         # Calculate how many weeks we can fit
-        if width_constraint is None:
+        if self.custom_width is not None:
+            width_constraint = self.custom_width
+        elif width_constraint is None:
             width_constraint = self.terminal_width - 8
 
         max_weeks = self._calculate_max_weeks(width_constraint)
         display_weeks = recent_weeks[-max_weeks:] if len(
             recent_weeks) > max_weeks else recent_weeks
 
+        # Determine how many days to show
+        days_to_show = 7
+        if self.custom_height is not None:
+            days_to_show = min(7, max(1, self.custom_height))
+
         # Prepare rows for each day of the week (Sun-Sat)
-        day_rows = [[] for _ in range(7)]
+        day_rows = [[] for _ in range(days_to_show)]
         for week in display_weeks:
             days = week.get('contributionDays', [])
-            for idx in range(7):
+            for idx in range(days_to_show):
                 day = days[idx] if idx < len(days) else {}
                 count = day.get('contributionCount', 0)
                 if spaced: