Skip to content

Releases: sametcn99/golter

0.1.3

18 Jan 16:27
@sametcn99 sametcn99
0.1.3
6617a89

Choose a tag to compare

View all tags
0.1.3 Latest
Latest

Full Changelog: 0.1.2...0.1.3

  • supported new extensions
Assets 2
Loading

0.1.2

17 Jan 23:53
@sametcn99 sametcn99
0.1.2
1b4eeac

Choose a tag to compare

View all tags
0.1.2

Full Changelog: 0.1.1...0.1.2

Release

Highlights

  • Expanded document conversion support: Added integration for Calibre and Pandoc.
  • Comprehensive test coverage: Established extensive testing across all converters and the TUI.

Added

  • Ebook Formats: Support for MOBI, AZW, AZW3, and FB2 formats.
  • DOCX Conversion: Enabled DOCX support via Pandoc integration.
  • Calibre Integration: Integrated Calibre for advanced conversion capabilities.
  • Test Suites: New tests for audio, document, image, and video converters, as well as the TUI.

Improvements

  • Enhanced document conversion reliability and error handling.
  • Expanded test scenarios and implemented CI-friendly test tasks.

Docs

  • Updated installation and usage instructions in README.md to include Calibre, Pandoc, and the new task test command.

Internal

  • Added test runner/task command.
  • Expanded tests and test fixtures to cover new conversion scenarios.
Loading

0.1.1

17 Jan 14:07
@sametcn99 sametcn99
0.1.1
04ac08d

Choose a tag to compare

View all tags
0.1.1
  • Add version checking and update notification feature

Full Changelog: 0.1.0...0.1.1

Loading

0.1.0

17 Jan 01:00
@sametcn99 sametcn99
0.1.0
f86b3f2

Choose a tag to compare

View all tags
0.1.0

Full Changelog: https://github.com/sametcn99/golter/commits/0.1.0

Golter

Terminal-based file converter built with Go. It provides a modern, user-friendly Terminal User Interface (TUI) for batch converting images, videos, audio, and documents between various formats.

Features

  • Modern TUI Interface: Beautiful terminal interface with smooth animations and visual feedback.
  • Batch Conversion: Select multiple files and convert them all at once with concurrent processing.
  • Image Conversion: Native Go implementation for high-performance image processing with quality control.
  • Video Conversion: Leverages ffmpeg for robust video format support with optimized encoding presets.
  • Audio Conversion: Convert between various audio formats using ffmpeg with bitrate control.
  • Document Conversion: Support for PDF, Markdown, HTML, and EPUB conversions.
  • Keyboard Navigation: Full keyboard support with Vim-like keybindings (j/k, h/l).
  • Cross-Platform: Works on Linux, macOS, and Windows.
  • Compression Options: Choose from High, Balanced, or Compact quality levels.
  • Real-time Progress: Visual progress indicators during conversion.
  • Smart File Selection: Only files of the same type can be selected together for consistent conversions.

Supported Formats

Images

Input Output
.jpg, .jpeg, .png, .webp .jpg, .png, .webp

Features:

  • Quality-based compression (92% High, 75% Balanced, 55% Compact)
  • WebP lossless mode for highest quality
  • Optimized PNG compression levels

Videos

Input Output
.mp4, .avi, .mkv, .webm, .gif, .mov .mp4, .avi, .mkv, .webm, .gif, .mov

Features:

  • H.264/H.265 encoding for MP4/MKV
  • VP9 encoding for WebM
  • Optimized GIF creation with palette generation
  • Multi-threaded encoding
  • Fast-start enabled for MP4 streaming

Audio

Input Output
.mp3, .wav, .ogg, .flac, .m4a, .aac .mp3, .wav, .ogg, .flac, .m4a, .aac

Features:

  • Bitrate control (320k High, 192k Balanced, 128k Compact)
  • FLAC lossless support
  • Opus/Vorbis encoding for OGG

Documents

Input Output
.pdf, .md, .html .pdf, .md, .html, .epub
.csv .xlsx
.xlsx, .xls .csv

Features:

  • PDF text extraction to Markdown
  • Markdown to styled HTML with responsive design
  • Markdown/HTML to EPUB conversion
  • PDF compression/optimization
  • CSV to Excel conversion with styled headers and auto-fit columns
  • Excel to CSV export (exports first sheet)

Note: Video and audio conversion requires ffmpeg to be installed on your system.

Installation

Prerequisites

  • Go 1.21+
  • ffmpeg (required for video/audio conversion)

Quick Install

go install github.com/sametcn99/golter@latest

Build from Source

Using Taskfile (Recommended)

# Install task if not already installed
go install github.com/go-task/task/v3/cmd/task@latest

# Build and run
task build
./bin/golter
Command Description
task build Compiles to bin/golter
task run Runs the application
task clean Removes build artifacts
task test Runs the test suite
task fmt Formats the code
task build-all Cross-compiles for all platforms
task install Installs to GOPATH/bin

Platform-Specific Setup

Linux 
# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# Fedora
sudo dnf install ffmpeg

# Arch Linux
sudo pacman -S ffmpeg

# Build
go build -o golter main.go
./golter
macOS 
brew install ffmpeg
go build -o golter main.go
./golter
Windows 
# Using winget
winget install ffmpeg

# Or using chocolatey
choco install ffmpeg

# Build
go build -o golter.exe main.go
.\golter.exe

Usage

Start in current directory:

./golter

Start in a specific directory:

./golter /path/to/your/media

Keyboard Controls

Key Action
↑ / k Move cursor up
↓ / j Move cursor down
← / h Go to parent directory
→ / l Enter directory
Space Select/Deselect file
a Select all files of same type
d Deselect all files
Enter Open directory
c Confirm selection and proceed
/ Filter files
g Go to top
G Go to bottom
Esc Go back / Cancel
q Quit application

Workflow

  1. Navigate: Browse your file system using arrow keys or Vim bindings
  2. Select: Press Space to mark files (files must be of the same type)
  3. Confirm: Press c when done selecting files
  4. Choose Action:
    • Convert Format: Change file format (e.g., JPG → PNG)
    • Compress Files: Reduce size while keeping format
  5. Configure:
    • Convert: Select target format
    • Compress: Choose quality level
  6. Process: Watch the progress as files are converted concurrently

License

GPL-3.0

Loading