https://github.com/denoyey/convex
A lightweight Python CLI tool to convert between CSV, Excel, and JSON — with drag & drop, encoding detection, and multi-sheet support.
https://github.com/denoyey/convex
conversion convert csv csv-files drag-and-drop encoding excel it-support json multi-sheet-excel python recent-files toolkit tools
Last synced: 7 months ago
JSON representation
A lightweight Python CLI tool to convert between CSV, Excel, and JSON — with drag & drop, encoding detection, and multi-sheet support.
- Host: GitHub
- URL: https://github.com/denoyey/convex
- Owner: denoyey
- Created: 2025-07-21T08:21:43.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-07-21T09:05:23.000Z (8 months ago)
- Last Synced: 2025-07-21T10:23:45.224Z (8 months ago)
- Topics: conversion, convert, csv, csv-files, drag-and-drop, encoding, excel, it-support, json, multi-sheet-excel, python, recent-files, toolkit, tools
- Language: Python
- Homepage:
- Size: 352 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📄 Convex – File Conversion Toolkit
**Convex** is a lightweight and efficient command-line tool to **convert CSV, Excel, and JSON files** easily. It supports drag-and-drop, multi-sheet Excel handling, encoding detection, and maintains a recent file history.
## 📚 Table of Contents
- [📄 Convex – File Conversion Toolkit](#-convex--file-conversion-toolkit)
- [🛠️ Features](#️-features)
- [📸 Screenshot](#-screenshot)
- [⚙️ Installation](#-installation)
- [🚀 Usage](#-usage)
- [🧠 Tech Stack](#-tech-stack)
- [🖥️ Platform Support](#️-platform-support)
- [🧾 License](#-license)
- [🙌 Acknowledgements](#-acknowledgements)
## 🛠️ Features
* ✅ Convert **CSV → Excel (.xlsx)**
* ✅ Convert **JSON → CSV**
* ✅ Convert **Excel (.xls/.xlsx) → CSV**
* ✅ Convert **CSV → JSON**
* ✅ Convert **Excel Multi-Sheet → CSV (auto split)**
* ✅ Drag-and-drop support
* ✅ Encoding detection with `chardet`
* ✅ History of recent files used
## 📸 Screenshot
## ⚙️ Installation
#### STEP 1 – Clone Repository
```bash
git clone https://github.com/denoyey/Convex.git
```
#### STEP 2 – Move to Project Folder
```bash
cd Convex
```
#### STEP 3 – Install Dependencies
```bash
pip install -r requirements.txt --break-system-packages
```
##### Dependencies include:
- pandas
- chardet
- xlrd
- openpyxl
- termcolor
## 🚀 Usage
#### To run Convex, use the following command:
```bash
python convex.py
```
#### Or, if you're using Python 3 explicitly:
```bash
python3 convex.py
```
> 💡 You can drag and drop files or folders into the terminal when prompted.
>
> 📁 The tool will automatically preview data and help you choose an output location.
## 🧠 Tech Stack
- Python 3.7+
- Pandas
- OpenPyXL / xlrd
- Termcolor
- Chardet
## 🖥️ Platform Support
- ✅ Windows
- ✅ macOS
- ✅ Linux
###### (Note: Tab auto-completion works best on UNIX systems.)
## 🧾 License
Licensed under the MIT License
## 🙌 Acknowledgements
Built with care by @denoyey || © 2025 – All Rights Reserved.