{"id":19224550,"url":"https://github.com/ycatsh/boring-fox","last_synced_at":"2025-04-05T19:09:33.931Z","repository":{"id":64167233,"uuid":"480447321","full_name":"ycatsh/boring-fox","owner":"ycatsh","description":"Retro and minimalist (but boring) firefox theme with convenient features","archived":false,"fork":false,"pushed_at":"2025-03-09T08:19:03.000Z","size":2022,"stargazers_count":124,"open_issues_count":0,"forks_count":12,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-29T18:06:28.442Z","etag":null,"topics":["css","firefox","firefox-css","firefox-theme","html","javascript","responsive-css","userchromecss"],"latest_commit_sha":null,"homepage":"https://ycatsh.github.io/boring-fox/","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/ycatsh.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":"2022-04-11T15:48:47.000Z","updated_at":"2025-03-16T03:35:56.000Z","dependencies_parsed_at":"2025-01-14T11:11:12.540Z","dependency_job_id":"5cefad98-d126-4f59-8666-632b8cf8eef0","html_url":"https://github.com/ycatsh/boring-fox","commit_stats":null,"previous_names":["ycatsh/smart-fox","ycatsh/boring-fox"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ycatsh%2Fboring-fox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ycatsh%2Fboring-fox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ycatsh%2Fboring-fox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ycatsh%2Fboring-fox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ycatsh","download_url":"https://codeload.github.com/ycatsh/boring-fox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247386263,"owners_count":20930618,"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":["css","firefox","firefox-css","firefox-theme","html","javascript","responsive-css","userchromecss"],"created_at":"2024-11-09T15:12:12.869Z","updated_at":"2025-04-05T19:09:33.794Z","avatar_url":"https://github.com/ycatsh.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![graphic](./.github/assets/main.png)\n\u003cbr\u003e\n\nBoring-Fox is primarily developed with [JavaScript](https://en.wikipedia.org/wiki/JavaScript) and [CSS](https://developer.mozilla.org/en-US/docs/Web/CSS). It offers a sophisticated and convenient start page for users who are just a tad bit boring. With its minimal and retro design, Boring-Fox combines boring aesthetics with functionality. The theme enhances your Firefox homepage by providing easy access to bookmarks, weather widgets, as well as unit and currency conversion within a single, cohesive interface.\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n    \n![stars](https://img.shields.io/github/stars/ycatsh/Boring-Fox?\u0026color=2e2e2f\u0026labelColor=202020\u0026style=for-the-badge)\n![issues-closed](https://img.shields.io/github/issues-closed/ycatsh/Boring-Fox?color=2e2e2f\u0026labelColor=202020\u0026style=for-the-badge)\n![issues-open](https://img.shields.io/github/issues/ycatsh/Boring-Fox?color=2e2e2f\u0026labelColor=202020\u0026style=for-the-badge)\n    \n\u003c/div\u003e\n\n## Features\nBoring-Fox offers a window with tabs-like buttons to organise its functionality. It isn't cluttered; rather, thoughtfully placed with the intent of keeping your homepage distraction-free. \n\n\u003cbr\u003e\n\n### Tab based bookmarks\n![1](./.github/assets/tabs.png)\n\u003cbr\u003e\nOrganize your several bookmarks efficiently via tabs. To customize your bookmarks, open `scripts/tabs.js` and edit the links as required. The bookmarks are formatted in json format in the file for easy modification.\n\n\u003cbr\u003e\n\n### Weather Information \n![2](./.github/assets/temp.png)\n\u003cbr\u003e\nCheck the weather right on your Firefox homepage for convenient access to up-to-date information. To set this up make an account with [openweathermap](https://openweathermap.org/) and paste your API key in the `scripts/temp.js` file.\n\n\u003cbr\u003e\n\n### Useful Tools \n![3](./.github/assets/conv.png)\n\u003cbr\u003e\nConvert currencies and units whenever you want. To set up currency conversion make an account with [exchangerate-api](https://app.exchangerate-api.com/) and paste your API key in the `scripts/conv.js` file.\n\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\n## Configuration  \nThe theme can be configured and customized by editing the `scripts/tabs.js`, `scripts/temp.js`, `scripts/conv.js` files. It is pretty self explanatory but it allows you to update/add the following:  \n1. `tabs.js`: Add and customize bookmarks.\n2. `temp.js`: API key and location information.\n3. `conv.js`: API key and add/change currencies (use ISO 4217 currency codes).\n\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\n## Instructions   \nThe below step-by-step guide is divided into three parts: modifying the new tab and homepage, userChrome.css mods, and colors. If you want the same look as the screenshots, follow all three; otherwise, you can choose to use your own colors or skip the userChrome.css mods as needed.\n\n### Custom Firefox Styling (userChrome.css mods)\n\n1. On the Firefox url bar, enter `about:config` and set `toolkit.legacyUserProfileCustomizations.stylesheets` to `true` to enable CSS customization. \n\n2. Enter `about:profiles` on the url bar and open the root directory under `deafult-release` to go to your profile folder \n   \n3. Copy `chrome/` and `boring-fox/` from this repo into the profile folder.\n\n### Custom homepage/startpage (as newtab too)\n\n1. Find your Firefox directory corresponding to your operation system:\n- Linux: output of `whereis firefox`\n- Windows: `C:\\Program Files\\Mozilla Firefox`\n- MacOS: `/Applications/Firefox.app/Contents/MacOS`\n   \n1. Under `default/prefs` create or update `autoconfig.js` and paste in the code below:\n    ```javascript\n    //\n    pref(\"general.config.filename\", \"autoconfig.cfg\");\n    pref(\"general.config.obscure_value\", 0);\n    pref(\"general.config.sandbox_enabled\", false); \n    ```\n\n2. Navigate two directories back to the Firefox directory and create `autoconfig.cfg` and paste in the code below. Make sure to pass the path of the `boring-fox/index.html` file into `newTabURL` (it should look something like this: `file:///\u003cpath_to_firefox_dir\u003e/boring-fox/index.html`):  \n    ```javascript\n    //  \n    var {classes:Cc,interfaces:Ci,utils:Cu} = Components;  \n    \n    try {  \n    ChromeUtils.defineESModuleGetters(this, {\n      AboutNewTab: \"resource:///modules/AboutNewTab.sys.mjs\",\n    });  \n    var newTabURL = \"file:///PATH_TO_YOUR_INDEX.html\"; // Add the path to your index.html file here\n    AboutNewTab.newTabURL = newTabURL;  \n    } catch(e){Cu.reportError(e);} // report errors in the Browser Console  \n    ```\n\n3. Change homepage under Firefox settings to 'Custom URLs' and paste in the same path (to the index.html) as step 2.\n\n4. Restart Firefox. \n\n### Colors\n\n1. Download the [Firefox Color](https://addons.mozilla.org/en-US/firefox/addon/firefox-color/) add-on. To use the default colors of the theme, click [here](https://color.firefox.com/?theme=XQAAAAKEAwAAAAAAAABBKYhm849SCicxcUUSqiuG_ebZUZXOFqq-xzYqmKAKYyDZnHmbjO_VoNYUbmDc3gyZbFcmGEcSMfG8ny6dpdlnCVFOUqWQLLOzXX9FMWXkGoYmv23LdNR0bxjv21c6KuertwF-2DfJrieaJoQiNFgzILPpf7JMvqJC3-4gCbd-jB8szjUT20cXTTEvNV51fgMppmUS9oPJ17SnB84E6hdIg0ll2YYSCofK4P2Komedrb2jIs6b2I2_217C1iobfQ8vbPNz5whJrWZPuzNOFL60yNcXibipXbZddNhCNiBUOfxwgsjHhJAOwGsvPRjpul33ZP4dYjkM1-8zDfX4JS4iS0xZcyahdrJi_th_tTbCnhfq3sfXFkNthF2fVUAyyU8fpCb6uVF3xaPr_Z2Be1xlSY_2pCchjmuvnVCoBOCyxxOBQ5ltOt5eskg0zSl47hr4LP9g8E1MyzfhxxGwW4zU5j1ZRW_bBajyUw3VDGublCv9KsT1) to add them to Firefox. You can also customize the colors to your liking. \n\n\u003cbr\u003e\n\n## Fonts\n\nThe font files are already present in the theme. If you want to manually incorporate the required fonts into the theme, download [Minecraftia](https://www.dafont.com/minecraftia.font), [Fira Mono](https://fonts.google.com/specimen/Fira+Mono), and [Montserrat](https://fonts.google.com/specimen/Montserrat), then rename the font variables accordingly. Alternatively, you can choose any font by modifying the variables located at the top of the `style.css` file.\n\n\u003cbr\u003e\n\n## ASCII Art\n\nAll ASCII art, except for the graph found on the currency converter tab, is not created by me. Please find the sources for them below:  \n\n- **Retro Car**  \n  Source: [asciiart.website](https://asciiart.website/index.php?art=transportation/cars) (#5 on the page)\n\n- **Cat on Moon**  \n  Source: [textArt.sh](https://textart.sh/topic/moon) (#16 on the page)\n\n- **Book and Ink**  \n  Source: [ascii.co.uk](https://ascii.co.uk/art/books) (#3 on the page)\n\n\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Other Themes \nIf you're looking for a more streamlined and simple start page, you can find some of my older themes in the `other-themes/` directory. These are relatively simple and lightweight. Feel free to browse and choose from these themes.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fycatsh%2Fboring-fox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fycatsh%2Fboring-fox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fycatsh%2Fboring-fox/lists"}