ASD2CSV_APP

ASD2CSV_APP is a cross-platform desktop application for converting ASD spectrometer .asd files to .csv format and merging multiple CSV files into a single file using a clean, browser-based graphical interface.

The app runs locally on your computer and opens in your default web browser.

Features

• Convert one or more .asd files to .csv
• Merge multiple .csv files into one combined .csv file
• Automatic output/ folder creation
• Clean and minimal graphical interface
• macOS and Windows installers (via GitHub Releases)

---

Installation

macOS (Installer)

1. Download ASD2CSV.dmg from the Releases page
2. Open it
3. Drag ASD2CSV into Applications
4. Launch the app — your browser should open automatically

Windows (Installer)

1. Download ASD2CSV_Setup.exe from the Releases page
2. Run the installer
3. Launch ASD2CSV from the Start Menu

---

Run from Source (Developer Mode)

This mode is for users who want to run the application directly from the source code (no .dmg / .exe).

1) Clone the repository

git clone https://github.com/vah-khosravi/ASD2CSV_APP.git
cd ASD2CSV_APP

2) Create and activate a virtual environment

macOS / Linux

python3 -m venv .venv
source .venv/bin/activate

Windows (PowerShell)

py -m venv .venv
.\.venv\Scripts\Activate.ps1

Windows (CMD)

py -m venv .venv
.venv\Scripts\activate

3) Install dependencies

pip install -r requirements.txt

4) Run the GUI app (Flask local server)

python asd2csv_app.py     # Windows (CMD)

python3 asd2csv_app.py    #macOS / Linux

Opens in your browser:

http://127.0.0.1:5000

---

Usage

Convert ASD Files

1. In the app, click Convert ASD file(s) to CSV
2. Select one or more .asd files
3. Converted .csv files will be saved in the output/ folder in the user's documents folder. The output/ folder path can be found below the application tab.

Merge CSV Files

1. Click Merge CSV Files
2. Select two or more .csv files
3. A merged file named merged_spectra.csv will be created in the output/ folder in the user's documents folder. The output/ folder path can be found below the application tab.

---

Command Line Tools (Optional / Power Users)

If you prefer working in the terminal instead of the browser-based app, you can use the provided CLI tools for single-file conversion, batch processing, and CSV merging.

Convert a single ASD file

This will convert one .asd file within the Data/ folder into .csv and save it into the output/ folder.

macOS / Linux / Git Bash

python3 cli_convert.py Data/Spectrum00001.asd output

Windows PowerShell / CMD

python cli_convert.py Data\Spectrum00001.asd output

Batch convert all ASD files in a folder

This will convert all .asd files within the Data/ folder into .csv files and save them into the output/ folder.

macOS / Linux / Git Bash

python3 cli_convert.py Data output

Windows PowerShell / CMD

python cli_convert.py Data output

Merge all CSV files into one CSV file

This will merge all .csv files within the output/ folder into a single file named merged_spectra.csv and save it in the same output/ folder.

macOS / Linux / Git Bash

python3 cli_merge.py output output/merged_spectra.csv

Windows PowerShell / CMD

python cli_merge.py output output\merged_spectra.csv

---

Project Structure

ASD2CSV_APP/
├── asd2csv_app.py
├── asd_reader.py
├── csv_merger.py
├── cli_convert.py
├── cli_merge.py
├── requirements.txt
├── templates/
│   └── index.html
├── static/
│   ├── app.js
│   └── style.css
├── assets/
│   ├── icon.png
│   ├── icon.icns
│   └── icon.ico
├── LICENSE
└── README.md

---

License

This project is licensed under the Apache License 2.0.

See the full license text in the LICENSE file.

---

Cite This Software

If you use ASD2CSV in academic work, publications, or research, please cite it as follows:

APA

Khosravi, V. (2026). ASD2CSV: A cross-platform tool for converting ASD spectrometer files to CSV format. GitHub. https://github.com/vah-khosravi/ASD2CSV_APP

BibTeX

@software{Khosravi_ASD2CSV_2026,
  author  = {Khosravi, Vahid},
  title   = {ASD2CSV: A cross-platform tool for converting ASD spectrometer files to CSV format},
  year    = {2026},
  url     = {https://github.com/vah-khosravi/ASD2CSV_APP},
  note    = {Version 1.0.0}
}

Credits

ASD file parsing and conversion logic is based on publicly available ASD binary format specifications and adapted for this application.

Developed and maintained by Vahid Khosravi.