{"id":22104612,"url":"https://github.com/gabocapo/chatgptconverter","last_synced_at":"2025-04-10T01:06:29.091Z","repository":{"id":175478538,"uuid":"653950244","full_name":"GaboCapo/ChatGPTConverter","owner":"GaboCapo","description":"This tool enables the conversion of chat data from ChatGPT into Markdown format","archived":false,"fork":false,"pushed_at":"2023-07-18T01:44:34.000Z","size":42,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-10T01:06:25.303Z","etag":null,"topics":["bash","chatgpt","converter","html","markdown","md-file","md-file-converter","md-files","shell"],"latest_commit_sha":null,"homepage":"https://gabocapo.github.io/ChatGPTConverter/","language":"Shell","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/GaboCapo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2023-06-15T04:59:37.000Z","updated_at":"2025-02-22T18:18:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"30f64a58-1698-4e07-aaed-59c23e9120c1","html_url":"https://github.com/GaboCapo/ChatGPTConverter","commit_stats":null,"previous_names":["gabocapo/chatgptconverter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GaboCapo%2FChatGPTConverter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GaboCapo%2FChatGPTConverter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GaboCapo%2FChatGPTConverter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GaboCapo%2FChatGPTConverter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GaboCapo","download_url":"https://codeload.github.com/GaboCapo/ChatGPTConverter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137887,"owners_count":21053775,"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":["bash","chatgpt","converter","html","markdown","md-file","md-file-converter","md-files","shell"],"created_at":"2024-12-01T06:33:27.462Z","updated_at":"2025-04-10T01:06:29.065Z","avatar_url":"https://github.com/GaboCapo.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![ChatGPT](https://img.shields.io/badge/chatGPT-74aa9c?style=for-the-badge\u0026logo=openai\u0026logoColor=white)![Markdown](https://img.shields.io/badge/markdown-%23000000.svg?style=for-the-badge\u0026logo=markdown\u0026logoColor=white)\n![ChatGPTConverterSocialImage](https://github.com/GaboCapo/ChatGPTConverter/assets/39612138/501f6fb2-7578-453c-8651-f00db84bc58f)\n# ChatGPTConverter\n\nThis tool enables the conversion of chat data from ChatGPT into Markdown format\n\n## Table of contents\n\n- [Preparation](#preparation)\n- [Generate the html file](#generate-the-html-file)\n- [Download MD files](#download-md-files)\n\n\n## Preparation\n\nGo to the three dots in your ChatGPT interface and in settings go to the export data item.\n\n![image](https://github.com/GaboCapo/ChatGPTConverter/assets/39612138/841bbaef-615e-434b-a762-6c240eb1c640)\n\nAfter a few moments or sometimes longer, you will receive an email with a link where you can download this data.\n\nUnzip these files and you will find the following structure of data:\n\n```\n.\n├── chat.html\n├── conversations.json\n├── message_feedback.json\n├── model_comparisons.json\n├── shared_conversations.json\n└── user.json\n```\n\n## Generate the html file\n\nWe will now create an individual HTML file that is customized to your chat history. This is done with the **helper script** which is based on an [.sh Script](https://en.wikipedia.org/wiki/Shell_script). [²](https://en.wikipedia.org/wiki/Bourne_shell)\n\nFrom this point you can run this command:\n\n```\nmkdir ChatGPTConverter \u0026\u0026 cd ChatGPTConverter \u0026\u0026 curl -O https://raw.githubusercontent.com/GaboCapo/ChatGPTConverter/main/helper.sh\n```\n\nto create a folder called `ChatGPTConverter` and download the `helper.sh` file to this folder.\n\nThen place the `conversations.json` file from your export files into this folder, so that it is next to the `helper.sh`.\n\nRun the command, \n```\nchmod +x helper.sh\n```\nin the project directory to make the file executable.\n\nAfter that you can execute the script with \n\n```\n./helper.sh\n```\n\nThe script first asks which method of export should be selected.\n\nOption 1 = Without Markdown / Frontmatter Header \nThis option creates an export file **without** the frontmatter header.\n\nOption 2 = With Markdown / Frontmatter Header\nThis option creates an export file **with** the Frontmatter Header which has the following format:\n```\n---\ntitle: \ncreate_time: \nupdate_time: \nplugin_ids: null\nid: \nmoderation_results: \n---\n```\n\nAn HTML file will be generated in the same folder.\nThis can be opened with a browser just like the original `chat.hmtl` file. \n\n\n## Download MD Files\n\n![image](https://github.com/GaboCapo/ChatGPTConverter/assets/39612138/ff3aa410-c93c-4287-abbf-2b47d3924c0a)\n\n![image](https://github.com/GaboCapo/ChatGPTConverter/assets/39612138/a8f58f94-1d0c-405f-80d3-3c9769e93c02)\n\nWhen you have opened the created HTML file with your browser you can click on 'Export all to md Files' to download the MD files as single .md files.\n\nConfirm the message 'Download multiple files' in the browser with 'Allow'.\n\n## Automatic download\n\nIf you want the files to be downloaded automatically without clicking every time you need to disable the option 'Ask for location before downloading files' in the browser settings. \nIf this is enabled, the files can be saved one after the other.\n\nHave fun!\n\n## Known Issues\n\n### Code Quality Note ⚠️\nAs of Jun 2023, **it should be noted that the code does not claim to be complete and should be checked yourself if it is used productively!** This is a hobby project and everyone is invited to extend the project.\n\n### Large Files\nFor large `conversations.jsons` files ( in my test about 30 MB ) it may take a few minutes depending on your computer. This is due to the processing procedures.\n\n### Chat GPT Plugin Compatibility\nSince there are numerous plugins for ChatGPT and they partly have different output forms, it is not possible to consider them directly. If there are special wishes you are welcome to think about an implementation and contribute to the project.\n\n### Consideration of other files like model_comparisons.json\nThere are other files from the export archive that were also mentioned above, but they are not processed in the script. The code currently uses only the `conversations.json` file from the exported data.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabocapo%2Fchatgptconverter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabocapo%2Fchatgptconverter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabocapo%2Fchatgptconverter/lists"}