{"id":15066566,"url":"https://github.com/quentinmax/serial2excel","last_synced_at":"2026-01-03T12:02:32.949Z","repository":{"id":225213234,"uuid":"765371452","full_name":"quentinmax/Serial2Excel","owner":"quentinmax","description":"Command-line utility for capturing data from a serial connection and exporting it to an Excel spreadsheet a CSV or JSON file.","archived":false,"fork":false,"pushed_at":"2024-03-21T19:55:54.000Z","size":754,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-22T19:39:41.281Z","etag":null,"topics":["arduino","cli","csv","excel","serial","spreadsheet"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/serial2excel","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quentinmax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-29T19:42:30.000Z","updated_at":"2024-03-04T14:58:23.000Z","dependencies_parsed_at":"2024-09-29T11:20:53.357Z","dependency_job_id":null,"html_url":"https://github.com/quentinmax/Serial2Excel","commit_stats":null,"previous_names":["quentinmax/serial2excel"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentinmax%2FSerial2Excel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentinmax%2FSerial2Excel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentinmax%2FSerial2Excel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quentinmax%2FSerial2Excel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quentinmax","download_url":"https://codeload.github.com/quentinmax/Serial2Excel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243814893,"owners_count":20352038,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","cli","csv","excel","serial","spreadsheet"],"created_at":"2024-09-25T01:09:17.137Z","updated_at":"2026-01-03T12:02:32.897Z","avatar_url":"https://github.com/quentinmax.png","language":"TypeScript","readme":"![serial2excel-screenshot](https://github.com/quentinmax/Serial2Excel/assets/82818659/62dfc98d-ba84-4372-884c-3d69e31e5d01)\n\nSerial2Excel is a CLI for capturing data from a serial connection (e.g. Arduino) and exporting it to an Excel spreadsheet, a CSV or JSON file.\n\n\u003e If this package is helping you, maybe consider to\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/quentinhoehne)\n\n## Table of Contents\n\n- [Features](#features)\n- [Node Compatibility](#node-compatibility)\n- [Installation](#installation)\n- [Notes](#notes)\n- [Usage](#usage)\n  - [Options](#options)\n- [Examples](#examples)\n- [Errors](#errors)\n- [License](#license)\n\n## Features\n\n- Capture data from a serial device.\n- Process incoming data in real-time.\n- Generate Excel, CSV or JSON files containing the processed data.\n\n## Node Compatibility\n\nUse at least Node v16+, however `serial2excel` has not been tested on every singe NodeJS version. For best results you may stick to LTS versions. Issue reports related are highly appreciated.\n\n## Installation\n\nInstall `serial2excel` globally using npm:\n\n```bash\nnpm install -g serial2excel\n```\n\nor run\n\n```bash\nnpx serial2excel [port] [options]\n```\n\n## Notes\n\n- Ensure that no other devices or programs are utilizing the serial connection before running the command.\n- If you don't include file extensions in your output file path, the CLI will add them based on the chosen file type (see [first example](#examples)).\n- If you have any occuring issues, [email me](mailto:quentinhoehne.dev@gmail.com) or create a [Github issue](https://github.com/quentinmax/Serial2Excel/issues).\n- If you are using Windows PowerShell make sure two wrap your columns in quotation marks `-c 'Column1,Column2,Column3'`. Otherwise PowerShell parses the commas wrong, resulting in an error.\n- Use -h or --help to display information about the available options.\n\n## Usage\n\nOnce installed, you can use the serial2excel command to capture data from a serial device and export it to Excel, CSV or JSON format.\n\n\u003e Ensure that no other devices or programs are utilizing the serial connection before running the command.\n\n```bash\nserial2excel [port] [options]\n```\n\n1. Ensure that the serial device is configured to send data in a seperated format, such as `data1;data2;...`. You can define a custom seperator setting the `-s` flag. **Your serial monitor must be set to use** `NR \u0026 CR`.\n\n![serial-monitor-screenshot](https://github.com/quentinmax/Serial2Excel/assets/82818659/7ce5d819-2d70-4066-87b4-b1109e74b2eb)\n\n2. Start Serial2Excel by running it in your terminal or command prompt. **Define the columns so they fit to the data your sending**.\n\n3. The CLI will capture data from the serial device automatically as it's sent.\n\n4. When you're done sending data, send the command `stop` via the serial device. This signals to the CLI that data transmission is complete.\n\n5. Once the data processing is complete the output file will be generated (Excel spreadsheet / CSV / JSON).\n\n\u003e If you have any occuring issues, do not hesitate to [email me](mailto:quentinhoehne.dev@gmail.com) or create a [Github issue](https://github.com/quentinmax/Serial2Excel/issues).\n\n### Options\n\n```\n-V,  --version                       output the version number\n-br, --baud-rate \u003cnumber\u003e            set baud rate for serial communication (default: 9600)\n-t,  --type \u003cfiletype\u003e               set expected file type (choices: \"xlsx\", \"csv\", \"json\", default: \"xlsx\")\n-s, --seperator \u003cseparator\u003e          set custom seperator - this will only effect the data your sending, not the columns specified in the cli (default: \";\")\n-o,  --output \u003cfilepath\u003e             define the output file path and filename. (e.g. '/path/to/file/filename')\n-c,  --columns \u003ccol1,col2,...\u003e       define the columns of the table (e.g. 'Song,Musician,Album')\n-h,  --help                          display help for command\n```\n\n## Examples\n\n1. You have an Arduino running on port 'com4', which sends weather data including Temperatur, Humidity and Pressure formatted as `Temperatur;Humidity;Pressure`. You want to export the data as CSV.\n   Your command prompt might look like this:\n\n```bash\n    serial2excel com4 -t csv -o ./data -c 'Temperature,Humidity,Pressure'\n```\n\n2. Your serial device runs on port '/dev/ttyUSB0' and sends data about a hardware device your testing and debugging. The device operates at 115200 baud and the data is formatted as `Acceleration|Speed|Timestamp`.\n\n```bash\n    serial2excel /dev/ttyUSB0 -o ./data.xlsx -br 115200 -s '|' -c 'Acceleration,Speed,Timestamp'\n```\n\n\u003e Note: Changing the seperator only applies to the data your sending from your serial device. In the CLI itself, use the comma.\n\n## Errors\n\n### Invalid user input (100)\n\n- `101`: Invalid Port. Make sure you choose the right port, where the serial connection is running on.\n\n### Invalid Data (300)\n\n- `301`: Column mismatch. The provided data has more columns than the table. Make sure every data row has the exact same columns. However you can bypass this, by adding more columns to the `-c` flag than actually needed (e.g. `-c 'Temperatur,Humidity,Pressure,-,-,...'`), though this is not recommended.\n\n### Internal (500)\n\n- `501`: Error writing to file. Try again later.\n\n## License\n\n[MIT](https://github.com/quentinmax/Serial2Excel/blob/master/LICENSE.md)\n","funding_links":["https://www.buymeacoffee.com/quentinhoehne"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquentinmax%2Fserial2excel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquentinmax%2Fserial2excel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquentinmax%2Fserial2excel/lists"}