{"id":16551225,"url":"https://github.com/michaelcurrin/history-report","last_synced_at":"2025-10-28T18:31:32.170Z","repository":{"id":93178580,"uuid":"162045894","full_name":"MichaelCurrin/history-report","owner":"MichaelCurrin","description":"Create page and domain CSV reports from your Chrome browsing history","archived":false,"fork":false,"pushed_at":"2020-06-02T19:03:53.000Z","size":54,"stargazers_count":7,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T17:11:13.423Z","etag":null,"topics":["browser-history","chrome-browser","chrome-history","csv","google-chrome","json","python","python3","report-generator"],"latest_commit_sha":null,"homepage":"","language":"Python","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/MichaelCurrin.png","metadata":{"files":{"readme":"README.md","changelog":"historyreport/etc/config.template.py","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":"2018-12-16T22:14:03.000Z","updated_at":"2024-05-17T14:34:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"76ae2251-bd32-43b4-8474-23e201a558fb","html_url":"https://github.com/MichaelCurrin/history-report","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhistory-report","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhistory-report/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhistory-report/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhistory-report/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MichaelCurrin","download_url":"https://codeload.github.com/MichaelCurrin/history-report/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238700282,"owners_count":19515896,"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":["browser-history","chrome-browser","chrome-history","csv","google-chrome","json","python","python3","report-generator"],"created_at":"2024-10-11T19:36:41.024Z","updated_at":"2025-10-28T18:31:26.873Z","avatar_url":"https://github.com/MichaelCurrin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# History Report\n\u003e Create page and domain CSV reports from your Chrome browsing history\n\nGoogle Chrome lets you view and search your browsing history, although with limitations on metadata and the ability to filter or sort. Though you can export your data to an XML file from the browser or get a JSON download from your Google account, those raw data files are still inconvenient to use.\n\nTherefore this project provides Python 3.6 tool to convert your own downloaded browsing history JSON into two easy-to-use CSV reports which you can search, filter and sort in a CSV editor.\n\nTitle             | Description\n---               | ---\n**Page Report**   | List of URLs in the history events, including the last visit time, domain and page title. Sorted by URL.\n**Domain Report** | Summary of unique domains and counts of pages associated with each. Sorted by domain but easily sortable by page count.\n\n\n## Example usage\n\n### CLI\n\n```bash\n$ ./historyreport.py [OPTIONS]\n```\n\nFlag         | Description\n---          | ---\n-h           | Show help message and exit.\n-e --exclude | If provided, read the configured exclusions CSV and exclude any URLs in the file before writing the CSV report.\n\n### Samples\n\nSample input files:\n\n- [BrowserHistory.json](/historyreport/var/samples/BrowserHistory.json)\n- [exclusions.csv](/historyreport/var/samples/exclusions.csv)\n\nSample output files:\n\n- [page_report.csv](/historyreport/var/samples/page_report.csv)\n- [domain_report.csv](/historyreport/var/samples/domain_report.csv)\n\n\n## Exclusions\n\nWhen creating the reports, certain domains or URLs will be excluded. This is done with a config, containing app defaults and user-defined items. For example, the app will ignore _www.facebook.com_ and you might decided to exclude Such as _gmail.com_.\n\nThis project cares about browsing events, so irrelevant events are ignored and define in `IGNORE_EVENTS` in [historyreport.py](history-report/historyreport/historyreport.py). \n\nIn that script, only _http_ and _https_ URLs are used, filtering out items like local file paths (`file:///`) and FTP URLs (`ftp://`).\n\n\n## Documentation\n\nSetup and run the application with the following in the [docs](/docs/) directory:\n\n- [Installation](/docs/installation.md)\n- [Usage](/docs/usage.md)\n\n\n## Privacy notice\n\nYour browsing history is kept **totally private** when using this project:\n\n- This project does *not* require access to the internet to run or your Google credentials to run.\n- No data is sent outside of this application - the only output is local CSV files in the project's unversioned `var` directory.\n\n\n## License\n\nReleased under [MIT](/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelcurrin%2Fhistory-report","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelcurrin%2Fhistory-report","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelcurrin%2Fhistory-report/lists"}