Releases: S1mplector/Koware
Koware v1.0.4
Koware v1.0.4 Release Notes
Major Release
Welcome to Koware v1.0.4
New Features
Cross-Platform Support
- Full Linux support with dedicated installer scripts
- One-line installer:
curl -fsSL https://raw.githubusercontent.com/S1mplector/Koware/main/Scripts/install-koware-linux.sh | bash - Package support for
.deb(Debian/Ubuntu) and tarball distributions - ARM64 and x64 architecture support
Data Synchronization
- New
koware synccommand for cross-device data synchronization - Git-based sync engine with automatic change detection
- Optional GitHub CLI integration for private repo creation
- Background sync with configurable triggers
Interactive Explorer
- New
koware explorecommand replacing the old search interface - Interactive catalog browser with provider selection
- Popular content discovery mode
- Enhanced search with filtering options
- Direct query support:
koware explore "naruto" --quick
Intelligent Auto-Configuration (Experimental for now)
- Advanced pattern recognition engine for automatic provider detection
- GraphQL introspection for deep API schema discovery
- Intelligent response analysis for field mapping
- Enhanced site profiling with heuristic-based detection
Technical Improvements
Database & Storage
- SQLite encryption with SQLitePCLRaw.bundle_e_sqlcipher
- Enhanced data integrity and security
- Aggregate catalog system combining built-in and dynamic providers
- Improved performance for large datasets
Architecture Enhancements
- AggregateAnimeCatalog and AggregateMangaCatalog for unified provider management
- Modular auto-config system with pluggable components
- Enhanced error classification and reporting
- Improved dependency injection patterns
.NET 9 Runtime
- Updated to .NET 9 SDK for source builds
- Improved performance and latest framework features
- Enhanced cross-platform compatibility
Platform Support
| Platform | Status | Installer |
|---|---|---|
| Windows | Full | Installer + PowerShell |
| macOS | Full | DMG + Shell scripts |
| Linux | New | One-line installer + .deb |
Command Changes
New Commands
koware explore- Interactive catalog browserkoware sync- Data synchronizationkoware sync init- Initialize sync repositorykoware sync on/off- Toggle background sync
Updated Commands
koware search- Now redirects toexplore(use--jsonfor scripting)- Enhanced
koware providerwith improved auto-config - Improved
koware doctorwith expanded diagnostics
Security & Privacy
- Encrypted local databases for sensitive data
- Enhanced provider validation and sandboxing
- Improved error handling to prevent information leakage
- Secure sync with optional encryption
Bug Fixes
- Fixed provider configuration parsing issues
- Resolved memory leaks in long-running operations
- Improved error recovery for network failures
- Enhanced terminal rendering on various consoles
- Fixed history database corruption issues
Performance Improvements
- Faster provider initialization with aggregate catalogs
- Optimized search with intelligent caching
- Reduced memory footprint for large catalogs
- Improved startup time with lazy loading
Documentation
- Updated tutorial system with current commands
- Enhanced help system with examples
- New Linux installation guide
- Improved troubleshooting documentation
Dependencies
Optional Dependencies
| Tool | Purpose |
|---|---|
| Git | Required for koware sync |
GitHub CLI (gh) |
Auto repo creation for sync |
Runtime Requirements
- .NET 9 Runtime (for source builds)
- SQLitePCLRaw for encrypted databases
Installation
Windows
.\install-koware.ps1 -PublishmacOS
./Scripts/publish-macos.shLinux (New!)
curl -fsSL https://raw.githubusercontent.com/S1mplector/Koware/main/Scripts/install-koware-linux.sh | bashMigration Notes
- Linux users: New dedicated installation scripts available
- Sync users: Run
koware sync initto set up cross-device sync - Search users: Use
koware explorefor enhanced search experience - Provider users: Re-run
koware provider autoconfigfor improved detection
What's Next
This release establishes Koware as a truly cross-platform solution with advanced data management capabilities. The new sync and explore features significantly enhance the user experience, while the intelligent auto-config system makes provider setup easier than ever.
Thank you for using Koware!
Version 1.0.4 marks our transition from beta to stable release with enterprise-ready features and cross-platform support.
Full Changelog: v0.8.2-beta...v1.0.4
Koware v0.8.2-beta
Koware v0.8.2 — Consistency Release
New Features
Experimental URL-based Provider Autoconfig
- New command:
koware provider autoconfig <url>- Automatically analyze websites and generate scraping configurations - Site probing, content detection, API discovery, schema generation
- Experimental feature with confirmation prompt and clear warnings about its status
- Generated configs are stored locally but not yet integrated with
watch/readcommands
Improved Error Handling
New ErrorDisplay System
- Unknown command now shows suggestions based on fuzzy matching (Levenshtein distance)
- Missing arguments now show clean usage hints for
searchandreadcommands - Network errors are logged with detailed troubleshooting steps and suggested commands
- Provider not configured errors show quick setup instructions
- Timeouts & cancellations show clear status messages
Bug Fixes
Manga List 'Read' Action
- Fixed: Pressing
[r]on a manga list entry now correctly launches the reader - Continues from the next chapter after your current progress (e.g., if at 70/149, opens chapter 71)
Manga Reader Zoom
- Fixed: Zoom percentage selector no longer clips content
- Changed from
transform: scale()to width-based scaling for proper scrolling support
Technical Improvements
- Added ErrorDisplay class in
Koware.Cli.Consolefor centralized error formatting - Added
onReadcallback support to InteractiveMangaListManager - Removed unused
LogNetworkHintfunction - Reduced noise from JSON parsing warnings in autoconfig (changed to Debug level)
Koware v0.8.1-beta
Koware v0.8.1-beta — Minor fix release
What's Changed
Bug Fixes
- Fixed anime streaming issues — Resolved problems with stream resolution and playback
Documentation
- Enhanced CLI help system — All commands now have comprehensive, detailed help via
koware help- Added usage examples for every command
- Documented all options and flags
- Added behavior explanations
- Included mode-specific information
Koware v0.8.0-beta
Koware v0.8.0-beta Release Notes
Highlights
fzf-Style Interactive Selector
This release introduces a completely rewritten interactive selector inspired by fzf, the beloved command-line fuzzy finder. The new selector brings a modern, responsive search experience to Koware's terminal interface.
Fuzzy Search
- Type to filter — Start typing anywhere in the selector to instantly filter results
- Intelligent scoring — Matches are ranked by relevance:
- Exact prefix matches score highest
- Substring matches score well
- Fuzzy matches (e.g., "ds" → "Demon Slayer") are supported
- Word boundary bonus — Abbreviations like "aot" correctly match "Attack on Titan"
- Consecutive character bonus — "dem" scores higher than "dmn" when matching "Demon"
Navigation & UX
- Quick jump — Press
1-9to instantly select visible items - Vim-style navigation — Arrow keys,
Page Up/Down,Home/End - Live preview panel — See descriptions and metadata while browsing
- Scroll indicators — Visual feedback showing your position in long lists
- Double-buffered rendering — Smooth, flicker-free updates
Other Improvements
Cross-Platform Icon Support
- Windows terminals now display ASCII fallback icons instead of broken emoji
- macOS terminals continue to show full emoji icons
- Automatic platform detection with no configuration needed
Redesigned Installer UI (Windows)
- Step-based progress — Clear visual feedback showing each installation phase
- Animated spinners — See exactly what's happening during install
- Checkmark indicators — Completed steps are marked with ✓
- Modern button styling — Rounded buttons with subtle blue gradients
- Cleaner, more professional appearance overall
|
Upgrade Notes
- This is a drop-in replacement for v0.7.0-beta
- No configuration changes required
- Watch history and settings are preserved
Known Issues
- Some very long titles may truncate in narrow terminals
Full Changelog: v0.7.0-beta...v0.8.0-beta
Koware v0.7.0-beta
Koware v0.7.0-beta
New Features
Video Player
- Resume playback
- Saves playback position every 10 seconds and on window close.
- Automatically resumes from the last position (per video URL) if:
- The save is less than 7 days old, and
- The previous position wasn’t near the very end of the video.
Manga Reader
-
Reading progress persistence
- Tracks the last-read page per chapter.
- Restores your page when reopening the same chapter if:
- The save is less than 30 days old, and
- The page count matches.
-
Theme settings
- New Theme menu with 4 modes:
- Dark (default) — Dark navy background and soft contrast.
- Sepia — Warm, paper-like background with a gentle sepia filter on images.
- Light — Clean light theme with white panel background.
- High Contrast — Pure black background and boosted image contrast.
- Selected theme is persisted and applied across sessions.
- New Theme menu with 4 modes:
-
Chapter navigation
- Chapters panel (header button):
- Slide-out panel on the right listing all chapters.
- Current chapter highlighted.
- Read chapters dimmed and labeled with a “Read” badge (based on CLI chapter metadata).
- Click a chapter to request navigation to it (communicated back via
--navfile).
- Prev / Next chapter buttons:
- New chapter-level navigation buttons in the footer.
- Disabled automatically when on the first or last chapter.
- Writing navigation intent (
prev/next) to the--navpath for the CLI to consume.
- Chapters panel (header button):
-
Legal & docs
- Updated Usage Notice to clarify:
- Koware does not host, store, or distribute content.
- Koware ships with no pre-configured sources; users add their own.
- Users are solely responsible for the sources they configure and the content they access.
- Updated README and installer packaging docs for
v0.7.0-betanaming and paths.
- Updated Usage Notice to clarify:
Bug Fixes
- Fixed mismatch where the CLI passed
--chapters/--navto the Windows reader before it understood those options. - Improved robustness around argument parsing and navigation result handling.
This is a beta release. Expect changes before the 1.0 release and please report issues or suggestions.
Koware v0.4.0-beta
Koware v0.4.0-beta
What's New
CLI Improvements
- New
koware versioncommand allows you to check your installed version withkoware version,--version, or-v - New
koware updatecommand allows you to update koware if your version is behind the latest version
Bug Fixes
- Fixed a version display bug where the CLI incorrectly showed the version as v0.1.0
Installer
- Added icons to buttons — Install, Remove, Browse, and Close buttons now have visual icons
Commands
- Help: To learn how to use the CLI in it's full extent, do
koware helporkoware help "command"to learn about a particular command.
Version
- 0.4.0-beta
Koware v0.3.0-beta
Koware v0.3.0-beta
Highlights
- New
downloadcommand for saving episodes or full shows locally.
New
CLI
-
downloadcommand- Syntax (examples):
koware download "Angel Beats" --episode 1koware download "Angel Beats" --episodes 1-5koware download "Angel Beats" --episodes all
- Supports:
- Single episode (
--episode N) - Ranges (
--episodes N-M) - All episodes (
--episodes all)
- Single episode (
- Uses the existing scraping/orchestration pipeline to pick the best stream and quality.
- Syntax (examples):
-
File naming & destination
- Default filename pattern:
"<Title> - Ep <N> [<Quality>].mp4"
- Filenames are sanitized to avoid illegal path characters.
- Default download directory:
- The current working directory, with support for overriding via CLI options.
- Default filename pattern:
Fixes / Reliability
- Fixed a compiler issue in the download planning logic (unassigned local variable) to ensure reliable packaging and publishing.
- Non-zero exit codes from ffmpeg surface as clear errors in the CLI.
- The child process is killed safely on failure/cancellation.
Upgrade Notes
- To install 0.3.0-beta:
- Use the new installer EXE as before; it will detect existing installs and offer Re-install / Remove.
- To update from 0.2.0-beta:
- Run the new installer → choose Re-install.
Commands
- Help: To learn how to use the CLI in it's full extent, do
koware helporkoware help "command"to learn about a particular command.
Version
- 0.3.0-beta
Koware v0.2.0-beta
Koware v0.2.0-beta
Highlights
- Installer now ships as a single-file EXE
- Search results ranked by similarity and visually highlighted
- Interactive selection supports “c to cancel”
New
- Installer
- Single-file, self-contained EXE
- Detects existing install and shows:
- Re-install
- Remove (uninstalls and removes PATH entry)
- CLI
- Similarity-ranked results for search/stream/watch
- Best match highlighted in bright yellow; others in darker yellow
- Interactive prompt: add “c to cancel”
Upgrade Notes
- To install: run the single EXE and accept the usage notice.
- To remove: run the installer → Remove.
Koware v0.1.0-beta
Koware 0.1.0-beta
- First public beta of Koware for Windows
- Includes the
Koware.Installer.Wininstaller package
Status
- Beta quality – features and behavior may change before 1.0
Feedback
- Please report crashes, unexpected behavior, and UI issues so they can be fixed before the 1.0 release.