{"id":17695771,"url":"https://github.com/insality/sheets-exporter","last_synced_at":"2025-05-12T14:12:27.130Z","repository":{"id":36552711,"uuid":"184446550","full_name":"Insality/sheets-exporter","owner":"Insality","description":"Sheets Exporter - CLI software for processing and save data from Google Sheets in seconds.","archived":false,"fork":false,"pushed_at":"2023-05-01T00:48:17.000Z","size":1002,"stargazers_count":14,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-12T14:12:16.821Z","etag":null,"topics":["automation","cli","data","export","google-sheets"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/Insality.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"insality","patreon":null,"open_collective":null,"ko_fi":"insality","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2019-05-01T16:31:12.000Z","updated_at":"2024-07-25T10:22:59.000Z","dependencies_parsed_at":"2024-10-24T16:51:50.833Z","dependency_job_id":"5fda7541-7763-4d0d-960b-b7e2b6dc4b14","html_url":"https://github.com/Insality/sheets-exporter","commit_stats":{"total_commits":63,"total_committers":3,"mean_commits":21.0,"dds":0.06349206349206349,"last_synced_commit":"e28a7ce79aed09b56b0afb4aa42f515e809328fd"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insality%2Fsheets-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insality%2Fsheets-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insality%2Fsheets-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insality%2Fsheets-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Insality","download_url":"https://codeload.github.com/Insality/sheets-exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253754220,"owners_count":21958842,"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":["automation","cli","data","export","google-sheets"],"created_at":"2024-10-24T14:06:53.701Z","updated_at":"2025-05-12T14:12:27.097Z","avatar_url":"https://github.com/Insality.png","language":"JavaScript","funding_links":["https://github.com/sponsors/insality","https://ko-fi.com/insality","https://www.buymeacoffee.com/insality"],"categories":[],"sub_categories":[],"readme":"![](media/exporter_logo.png)\n[![Github-sponsors](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=#EA4AAA)](https://github.com/sponsors/insality) [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/insality) [![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/insality)\n\n[![npm](https://img.shields.io/npm/v/sheets-exporter?label=sheets-exporter)](https://www.npmjs.com/package/sheets-exporter)\n\nSheets Exporter - CLI software for processing and save data from Google Sheets in seconds.\n\nSee  [Export Example](docs/05_example_export.md) to get the idea how it's work.\n\n## Features\n- Single command to download data from your Google Sheets\n- Save your data in JSON/LUA/CSV format\n- Use default data handlers to change your data in way your need\n- Use your custom handlers for your specific cases\n- Use hashtag `#` for comment rows or columns in Google Sheets\n- Use `\u003c\u003e` or `[]` for make arrays data in Google Sheets (need add `convert_array` handler)\n- Convert `true` or `false` (or Google checkbox values) values to JSON boolean values (need add `convert_boolean` handler)\n- Separate one Google list for several files _(usage example: game localization)_\n- Gather data from several Google lists in one file (for easier big data management)\n- Can process local files through handlers\n\n## Install\nThe installation time about 5 minutes ⏱️.\nPlease read the [instructions here](/docs/01_installation.md)\n\n## Setup configs\nGlossary next:\n - **Config** - contains the google sheets document ID, rules for this document and how to save it.\n - **Rule** - contains information about which data is collect (lists for Google Sheets or local files) and how it should be processed.\n \nAfter successful credentials and token setup you can setup **sheets-exporter** configs:\n- In any folder use `sheets-exporter init`\n\t- It will create basic config in default folder: `export_config`\n\t- you can move and edit this config if you want, but you need to pass the config path in the next commands otherwise\n- Inside your folder use `sheets-exporter add_sheet {sheet_name} {sheet_id}`\n\t- The sheet_name - is the name of Google Sheet document\n\t- The sheet_id - the Google Sheet document. Gather it from URL. Example: `1V1X5CmbHJOwIu09Oso25H-ephOdYWlAv0xzicp75RT8`\n- Inside your folder use `sheets-exporter add_rule {sheet_name} {list_name}`\n\t- The sheet_name - the name of config from previous step\n\t- The list_name - the name of Google Sheet list from document for export.\n\nYou can add any amount of rules to your document.\nAfter basic setup done, you can check it with `sheets-exporter export`\nThe **sheets-exporter** process files inside temp folder and after successful pipeline, upload it to save folder. Check output log:\n```\nUpload file /Users/test/export_config/export_result/TokensConfig.json\n```\n\nYou can check save folder inside your `config.json` file.\n\nFor more information how edit configs and use default and custom handlers please read the [instructions here](/docs/02_configs.md).\n\nYou can check full config example here: [Full Config Example](https://github.com/Insality/defold-eva/tree/master/export_config)\n\n\n## Documentation\nTo better understand **sheets-exporter**, read the following documentation:\n- [Install](docs/01_installation.md)\n- [Configs](docs/02_configs.md)\n- [Handlers](docs/03_handlers.md)\n- [See FAQ article](docs/04_faq.md)\n- [Export Example](docs/05_example_export.md)\n- [Full Config Example](https://github.com/Insality/defold-eva/tree/master/export_config)\n\n\n## License\nDeveloped and supported by [Insality](https://github.com/Insality)\n\n\n## Issues and suggestions\nIf you have any issues, questions or suggestions please  [create an issue](https://github.com/Insality/sheets-exporter/issues)  or contact me:  [insality@gmail.com](mailto:insality@gmail.com)\n\n\n## ❤️ Support project ❤️\n\nPlease support me if you like this project! It will help me keep engaged to update this project.\n\n[![Github-sponsors](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=#EA4AAA)](https://github.com/sponsors/insality) [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/insality) [![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/insality)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finsality%2Fsheets-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finsality%2Fsheets-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finsality%2Fsheets-exporter/lists"}