Skip to content

Commit 3742e74

Browse files
committed
feat: Release OpenConvert v1.3.3, featuring a complete UI overhaul, new history and analytics systems, and enhanced conversion capabilities.
1 parent 6016aa1 commit 3742e74

5 files changed

Lines changed: 320 additions & 1948 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ lerna-debug.log*
99

1010
node_modules
1111
dist
12+
dist-electron
1213
dist-ssr
1314
*.local
1415

README.md

Lines changed: 176 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,68 +1,195 @@
1-
<h1 align="center">
2-
<br>
3-
<a href="https://github.com/openconvert"><img src="./resources/logo.png" width="200"></a>
4-
<br>
5-
</h1>
1+
# OpenConvert
62

7-
<h4 align="center">OpenConvert is your swiss army knife for file convertion</h4>
3+
A fast, private, and user-friendly desktop file conversion application. Convert images, documents, videos, and audio files - all processed locally on your machine.
84

5+
![Version](https://img.shields.io/badge/version-1.3.3-blue)
6+
![License](https://img.shields.io/badge/license-GPL--3.0-green)
7+
![Platform](https://img.shields.io/badge/platform-Linux-lightgrey)
98

109
## Features
11-
- Convert multiple files at once
12-
- One click install in windows
13-
- Responsive Ui
14-
## Install
15-
- For executables checkout our [website](https://openconvert.github.io/website) or release [page](https://github.com/openconvert/openconvert-desktop/releases)
16-
<!-- ## Demo -->
17-
18-
19-
20-
## Supported files
21-
- Image: png, jpg, gif, webp, jxl, bmp, avif, tiff
22-
- Document: pdf, epub, xps, cbz, mobi, fb2 and many more ...
23-
- ~~Video: mp4, mkv, avi, mov, gif, 3gp~~
24-
- ~~Audio: aac, mp3, mp4a, wav~~
25-
## 🛠 Tech stack
26-
- Electronjs
27-
- Vuejs
28-
- Tailwindcss
29-
- Vite
30-
- daisyUI (component library)
31-
- Database Sqlite3
32-
## How to Contribute
33-
We need designer, tester and contributers. **OpenConvert** is prototype. If you want to contribute read [this](./CONTRIBUTING.md)
34-
### Install dependencies
3510

36-
```
37-
$ pnpm install
38-
```
11+
### Supported Formats
3912

40-
### Run app
13+
**Images** (Built-in via Sharp)
14+
- PNG, JPEG, WebP, GIF, BMP, AVIF, TIFF, SVG, ICO, JPEG XL
15+
- High-performance native processing
16+
- Quality control and lossless/lossy compression
4117

42-
```
43-
$ pnpm start
44-
```
45-
### Run dev server
46-
```
47-
$ pnpm dev
48-
```
49-
### Package app
18+
**Documents** (Requires Pandoc)
19+
- PDF, EPUB, DOCX, TXT, RTF, ODT, XPS, CBZ, MOBI, FB2
20+
- Powered by Pandoc for document transformations
21+
22+
**Video** (Requires FFmpeg)
23+
- MP4, MKV, AVI, MOV, WebM, 3GP, FLV, WMV
24+
- Real-time progress tracking
25+
- Video to GIF conversion
26+
27+
**Audio** (Requires FFmpeg)
28+
- MP3, WAV, AAC, OGG, FLAC, WMA, M4A
29+
- Real-time progress tracking
30+
31+
### Key Capabilities
32+
33+
- **Drag & Drop Interface** - Simply drag files into the app
34+
- **Batch Processing** - Convert multiple files simultaneously
35+
- **Quality Control** - Choose from Low, Medium, High, or Maximum quality presets
36+
- **Conversion History** - Track all your conversions with search and filter
37+
- **Analytics Dashboard** - View conversion statistics and performance metrics
38+
- **Overwrite Options** - Auto-rename, skip, or overwrite existing files
39+
- **Configurable Concurrency** - Control how many files convert at once (1-10)
40+
- **Privacy Focused** - 100% local processing, no internet required, no data collection
41+
- **Modern UI** - Dark theme with custom titlebar and responsive design
42+
43+
## Installation
44+
45+
### Prerequisites
46+
47+
**Required:**
48+
- Linux operating system (AppImage or Snap)
5049

51-
To build for windows:
50+
**Optional (for additional format support):**
51+
- [Pandoc](https://pandoc.org/installing.html) - For document conversions
52+
- [FFmpeg](https://ffmpeg.org/download.html) - For video and audio conversions
5253

54+
### Download
55+
56+
Download the latest release from the [Releases](../../releases) page:
57+
- **AppImage** - Portable, works on most Linux distributions
58+
- **Snap** - Install via Snap Store
59+
60+
### Running the AppImage
61+
62+
```bash
63+
chmod +x OpenConvert-*.AppImage
64+
./OpenConvert-*.AppImage
5365
```
54-
$ pnpm build:win
66+
67+
### Installing via Snap
68+
69+
```bash
70+
snap install openconvert
5571
```
56-
To build for linux:
72+
73+
## Usage
74+
75+
1. **Add Files** - Drag and drop files into the application, or click to browse
76+
2. **Select Format** - Choose the target format for each file from the dropdown
77+
3. **Configure Settings** - Adjust quality, output directory, and other options
78+
4. **Convert** - Click the convert button to start processing
79+
5. **View Results** - Check the History tab for completed conversions
80+
81+
### Keyboard Shortcuts
82+
83+
- `F12` or `Ctrl+Shift+I` - Toggle DevTools
84+
- `Ctrl+,` (Linux/Win) or `Cmd+,` (Mac) - Open Settings
85+
- `Ctrl+Shift+H` - Open History
86+
87+
## Development
88+
89+
### Tech Stack
90+
91+
- **Electron** - Desktop application framework
92+
- **React** - UI framework
93+
- **Vite** - Build tool and dev server
94+
- **TypeScript** - Type-safe JavaScript
95+
- **Tailwind CSS** - Utility-first styling
96+
- **Sharp** - Native image processing
97+
- **Better-SQLite3** - Database for history and settings
98+
- **shadcn/ui** - UI component library
99+
100+
### Prerequisites
101+
102+
- Node.js (v18 or higher recommended)
103+
- Bun (or npm/yarn)
104+
105+
### Setup
106+
107+
```bash
108+
# Clone the repository
109+
git clone https://github.com/yourusername/OpenConvert-desktop.git
110+
cd OpenConvert-desktop
111+
112+
# Install dependencies
113+
bun install
114+
115+
# Run in development mode
116+
bun run dev
57117
```
58-
$ pnpm build:linux
118+
119+
### Building
120+
121+
```bash
122+
# Build for Linux
123+
bun run build:linux
124+
125+
# Build for Windows
126+
bun run build:windows
127+
128+
# Build for macOS
129+
bun run build:mac
130+
131+
# Type-check and build without packaging
132+
bun run build:ts
59133
```
60-
To build for mac:
134+
135+
### Project Structure
136+
61137
```
62-
$ pnpm build:mac
138+
OpenConvert-desktop/
139+
├── electron/ # Electron main process
140+
│ ├── main.ts # Main process entry point
141+
│ └── preload.ts # Preload script for IPC
142+
├── src/ # React renderer process
143+
│ ├── components/ # UI components
144+
│ ├── config/ # Format configurations
145+
│ ├── lib/ # Utility functions
146+
│ └── App.tsx # Main application component
147+
├── public/ # Static assets
148+
└── resources/ # Build resources (icons, etc.)
63149
```
64150

151+
## Configuration
152+
153+
Settings are persisted in a SQLite database located at:
154+
- Linux: `~/.config/openconvert.db`
155+
156+
### Configurable Options
157+
158+
- Default output directory
159+
- Quality presets (Low/Medium/High/Maximum)
160+
- Overwrite behavior (Auto-rename/Skip/Overwrite)
161+
- Concurrency level (1-10 simultaneous conversions)
162+
- Maximum file size limit
163+
- Maximum file count per batch
164+
165+
## Contributing
166+
167+
Contributions are welcome! Please feel free to submit a Pull Request.
168+
169+
1. Fork the repository
170+
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
171+
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
172+
4. Push to the branch (`git push origin feature/amazing-feature`)
173+
5. Open a Pull Request
65174

66175
## License
67176

68-
GNU GPLv3
177+
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
178+
179+
## Acknowledgments
180+
181+
- [Sharp](https://sharp.pixelplumbing.com/) - High-performance image processing
182+
- [Pandoc](https://pandoc.org/) - Universal document converter
183+
- [FFmpeg](https://ffmpeg.org/) - Multimedia processing framework
184+
- [Electron](https://www.electronjs.org/) - Cross-platform desktop framework
185+
- [shadcn/ui](https://ui.shadcn.com/) - Beautiful UI components
186+
187+
## Support
188+
189+
If you encounter any issues or have questions:
190+
- Open an [issue](../../issues) on GitHub
191+
- Check the [documentation](../../wiki) (if available)
192+
193+
---
194+
195+
Made with care for privacy-conscious users who need reliable file conversions.

RELEASE_NOTES.md

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
# OpenConvert v1.3.3 Release Notes
2+
3+
After extensive development, we're excited to release OpenConvert v1.3.3 with major improvements, restored features, and a completely revamped user experience.
4+
5+
## What's Changed
6+
7+
This release represents a significant evolution of OpenConvert with a focus on feature completeness, user experience, and reliability.
8+
9+
## Major Features
10+
11+
### 🎨 Complete UI Overhaul
12+
* **Modern React + TypeScript stack** - Migrated from Vue.js to React for better performance and type safety
13+
* **New technology stack**: React 19, Electron, Vite, Tailwind CSS 4.2, shadcn/ui components
14+
* **Custom titlebar** - Frameless window with native-like controls
15+
* **Collapsible sidebar** - Toggle between expanded and compact views
16+
* **Dark theme** - Beautiful dark UI with violet/indigo gradient accents
17+
* **Responsive layout** - Adaptive interface that responds to window resizing
18+
19+
### 🔄 Restored & Enhanced Conversion Support
20+
* **✅ Image conversion** - Fully working with Sharp library (PNG, JPEG, WebP, GIF, BMP, AVIF, TIFF, SVG, ICO, JPEG XL)
21+
* **✅ Video conversion** - Restored with FFmpeg support (MP4, MKV, AVI, MOV, WebM, 3GP, FLV, WMV)
22+
* **✅ Audio conversion** - Restored with FFmpeg support (MP3, WAV, AAC, OGG, FLAC, WMA, M4A)
23+
* **✅ Document conversion** - Added Pandoc support (PDF, EPUB, DOCX, TXT, RTF, ODT, XPS, CBZ, MOBI, FB2)
24+
* **Real-time progress tracking** - Visual progress bars for video and audio conversions
25+
* **Video to GIF** - Convert video files to animated GIFs
26+
27+
### 📊 New: History System
28+
* **SQLite3 database integration** - Now actively in use (previously tested but unused)
29+
* **Complete conversion history** - Track all conversions with detailed metadata
30+
* **Search & filter** - Find conversions by filename and filter by status
31+
* **Grouped timeline** - Organized by Today, Yesterday, Last 7 days, Older
32+
* **Quick actions**:
33+
- Show file in folder
34+
- Delete individual entries
35+
- Clear all history
36+
* **Pagination support** - Efficiently handle large conversion histories
37+
38+
### 📈 New: Analytics Dashboard
39+
* **Conversion statistics** - Total conversions, success/failure rates, file sizes processed
40+
* **Format analytics** - Most used source and target formats
41+
* **Performance metrics** - Fastest, slowest, and average conversion times
42+
* **Category breakdown** - Conversions by type (image/video/audio/document)
43+
* **Visual stats cards** - Beautiful dashboard with color-coded metrics
44+
45+
### ⚙️ New: Complete Settings System
46+
* **General settings**:
47+
- Default output directory configuration
48+
- Auto-open folder after conversion
49+
- Show advanced settings toggle
50+
- Maximum file size and count limits
51+
* **Conversion settings**:
52+
- Quality presets (Low/Medium/High/Maximum)
53+
- Overwrite behavior (Auto-rename/Skip/Overwrite)
54+
- Concurrency control (1-10 simultaneous conversions)
55+
* **Persistent storage** - All settings saved to SQLite database
56+
* **Appearance options** - Theme preferences
57+
* **About section** - Version info and documentation links
58+
59+
### 🎯 Enhanced Conversion Experience
60+
* **Per-file format selection** - Choose different target formats for each file
61+
* **Per-file quality control** - Configure quality settings individually
62+
* **Batch processing** - Convert multiple files with configurable concurrency
63+
* **Smart thumbnail generation** - Automatic previews for images and videos
64+
* **Category-based organization** - Color-coded files by type (green=image, blue=document, yellow=video, pink=audio)
65+
* **Better error handling** - Clear error messages and status indicators
66+
* **Overwrite protection** - Auto-rename with numbered copies (file (1).jpg)
67+
68+
## UI Improvements
69+
70+
* **Enhanced drag & drop** - Improved file upload area with visual feedback
71+
* **File queue management** - Add, remove, and organize files before conversion
72+
* **Image preview** - Click thumbnails to preview uploaded images
73+
* **Status indicators** - Visual feedback for pending, converting, done, and error states
74+
* **Empty state onboarding** - Helpful UI when no files are loaded
75+
* **Keyboard shortcuts**:
76+
- `F12` / `Ctrl+Shift+I` - Toggle DevTools
77+
- `Ctrl+,` - Open Settings
78+
- `Ctrl+Shift+H` - Open History
79+
80+
## Technical Improvements
81+
82+
* **Technology stack changes**:
83+
- React 19.2.0 (from Vue.js)
84+
- TypeScript 5.9.3 for type safety
85+
- Vite 7.3.1 (maintained from electron-vite)
86+
- Tailwind CSS 4.2.1 (upgraded)
87+
- shadcn/ui component library (from daisyUI)
88+
- Better-SQLite3 12.6.2 for database operations
89+
* **Improved architecture**:
90+
- IPC communication between main and renderer processes
91+
- Centralized format configuration in `/src/config/formats.ts`
92+
- Better separation of concerns
93+
* **Build improvements**:
94+
- Linux AppImage and Snap support
95+
- Windows and macOS build configurations
96+
- Optimized electron-builder settings
97+
98+
## Plugins (Coming Soon)
99+
100+
* Placeholder view added for future plugin system
101+
* Planned: Custom converters via plugin architecture
102+
103+
## Bug Fixes
104+
105+
* Fixed file size handling and validation
106+
* Improved error messages for missing dependencies (FFmpeg, Pandoc)
107+
* Better handling of file overwrite scenarios
108+
* Fixed conversion queue management issues
109+
110+
## Breaking Changes
111+
112+
* Configuration from previous versions will not migrate automatically
113+
* New database schema for history and settings
114+
115+
## Requirements
116+
117+
* **Built-in support**: Image conversions work out of the box
118+
* **Optional dependencies**:
119+
- FFmpeg required for video and audio conversions
120+
- Pandoc required for document conversions
121+
122+
## Download
123+
124+
Available for Linux:
125+
- AppImage (portable)
126+
- Snap package
127+
128+
See the [Installation Guide](README.md#installation) for detailed instructions.
129+
130+
## What's Next
131+
132+
We're actively working on:
133+
- Enhanced plugin system for custom converters
134+
- More format support
135+
- Cloud storage integration
136+
- Batch conversion presets
137+
- Command-line interface
138+
139+
---
140+
141+
**Full Changelog**: [View all changes](../../compare/v1.0.0...v1.3.3)
142+
143+
Thank you to all contributors and users who provided feedback!

0 commit comments

Comments
 (0)