{"id":17675988,"url":"https://github.com/cardi/homepage","last_synced_at":"2026-05-05T07:33:02.819Z","repository":{"id":110993354,"uuid":"117041194","full_name":"cardi/homepage","owner":"cardi","description":"a default portal for your web browser","archived":false,"fork":false,"pushed_at":"2020-09-30T20:53:08.000Z","size":51,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-30T17:27:09.039Z","etag":null,"topics":["browser-home-page","chrome","firefox","homepage","homepage-tabs"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cardi.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":"2018-01-11T02:48:41.000Z","updated_at":"2020-09-30T20:53:10.000Z","dependencies_parsed_at":"2023-04-04T18:01:32.015Z","dependency_job_id":null,"html_url":"https://github.com/cardi/homepage","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cardi/homepage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fhomepage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fhomepage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fhomepage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fhomepage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cardi","download_url":"https://codeload.github.com/cardi/homepage/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fhomepage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32640535,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"online","status_checked_at":"2026-05-05T02:00:06.033Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-home-page","chrome","firefox","homepage","homepage-tabs"],"created_at":"2024-10-24T07:24:05.073Z","updated_at":"2026-05-05T07:33:02.803Z","avatar_url":"https://github.com/cardi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# homepage\n\n**homepage** generates a customized portal for your default page that's\nopened when you open a new tab or browser window.\n\nThe list of categories and pages is specified and maintained in a\nYAML-formatted file (`index.yaml`).\n\n## Dependencies\n\n* python3\n* PyYaml (`convert.py`, `generate.py`)\n* BeautifulSoup (`convert.py`)\n\nUsing MacPorts:\n```bash\nsudo port install python37 py37-beautifulsoup4 py37-yaml\n```\n\n## Usage\n\nTo generate your homepage (`generate.py`):\n\n1. Edit `index.yaml` with your categories and links (you can also\ngenerate your list of links from your exported bookmarks.html via\n`python3 convert.py bookmarks.html \u003e index.yaml`)\n2. (*optional*) Modify `index.m4` with your custom styles\n3. Run `make`\n4. Point your browser's home page to `/path/to/homepage/index.html`:\n\n   *Firefox*: Preferences \u003e \"Home page\"\n\n   *Chrome*:\n   1. Settings \u003e \"On startup\" \u003e \"Open a specific page or set of pages\"\n   2. Settings \u003e \"Appearance\" \u003e \"Show home button\" \u003e \"Enter custom web address\"\n\nYou can click on each site link individually, or click on the category\nname to open all the sites in each category at once.\n\n## Setting Your New Tab Page to Your Generated Homepage\n\nSetting your New Tab page typically requires an add-on or extension.\n\nFirefox users can use [New Tab Override][nto] to display this homepage\nwhen opening a new tab (in addition or as opposed to a new window).\nHowever, due to Firefox's APIs, using this feature requires you to\n\"upload\" the page to the extension, storing a copy in the extension\nitself: whenever you update your homepage, you also have to upload it\nagain to this extension.\n(The other alternative is to host it on a local or remote webserver,\nwhich we don't cover here).\n\n[nto]: https://addons.mozilla.org/en-US/firefox/addon/new-tab-override/\n\n## Example\n\n`index.yaml`:\n```yaml\n\"procrastination\":\n  - \"hacker news\": https://news.ycombinator.com\n  - \"newsblur\": https://newsblur.com\n  - \"arstechnica\": https://arstechnica.com\n\n\"reddit\":\n  - \"top\": https://reddit.com/\n  - \"popular\": https://reddit.com/r/popular\n  - \"all\": https://reddit.com/r/all\n  - \"random\": https://reddit.com/r/random\n```\n\n`index.html`:\n![screenshot of a generated homepage portal](example.png)\n\n## Contributing\n\nAll of the template code (CSS, JS, HTML) can be found in `index.m4`.\nThe webpage is styled very simply with CSS Grid.\n\nThe `Makefile` executes `generate.py`, which outputs an HTML snippet,\nand uses `m4` to generate the final HTMl.\n\nFeel free to contribute code or send comments, suggestions, bugs to\ncalvin@isi.edu.\n\n## LICENSE\n\n[CC0 1.0 Universal](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcardi%2Fhomepage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcardi%2Fhomepage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcardi%2Fhomepage/lists"}