{"id":30865833,"url":"https://github.com/greeeen-dev/natsumi-browser","last_synced_at":"2026-06-13T22:01:28.646Z","repository":{"id":268228544,"uuid":"899465460","full_name":"greeeen-dev/natsumi-browser","owner":"greeeen-dev","description":"Welcome to your personal internet.","archived":false,"fork":false,"pushed_at":"2026-06-11T00:49:34.000Z","size":109506,"stargazers_count":707,"open_issues_count":7,"forks_count":25,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-06-11T01:21:11.776Z","etag":null,"topics":["firefox","firefox-browser","firefox-css"],"latest_commit_sha":null,"homepage":"https://natsumi.greeeen.dev","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/greeeen-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-06T10:19:47.000Z","updated_at":"2026-06-10T23:02:52.000Z","dependencies_parsed_at":"2024-12-30T18:29:51.360Z","dependency_job_id":"64b024c8-be29-4eeb-97bb-7abd4d39f076","html_url":"https://github.com/greeeen-dev/natsumi-browser","commit_stats":null,"previous_names":["greeeen-dev/natsumi-browser"],"tags_count":144,"template":false,"template_full_name":null,"purl":"pkg:github/greeeen-dev/natsumi-browser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greeeen-dev%2Fnatsumi-browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greeeen-dev%2Fnatsumi-browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greeeen-dev%2Fnatsumi-browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greeeen-dev%2Fnatsumi-browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/greeeen-dev","download_url":"https://codeload.github.com/greeeen-dev/natsumi-browser/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greeeen-dev%2Fnatsumi-browser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34301732,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"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":["firefox","firefox-browser","firefox-css"],"created_at":"2025-09-07T22:01:46.938Z","updated_at":"2026-06-13T22:01:28.494Z","avatar_url":"https://github.com/greeeen-dev.png","language":"JavaScript","funding_links":[],"categories":["CSS","JavaScript"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg width=\"420\" src=\"./images/kawaii-pride.png\"\u003e\n  \u003cbr\u003e\n  Natsumi Browser\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Welcome to your \u003cstrong\u003epersonal\u003c/strong\u003e internet.\n\u003c/p\u003e\n\u003ch5 align=\"center\"\u003e\n  \u003ca href=\"https://natsumi.greeeen.dev\"\u003eWebsite\u003c/a\u003e • \u003ca href=\"https://natsumi.greeeen.dev/discord\"\u003eDiscord\u003c/a\u003e • \u003ca href=\"https://fluxer.gg/natsumi\"\u003eFluxer\u003c/a\u003e\n\u003c/h5\u003e\n\n![](./images/main-backgroundless.webp)\n\n## Meet Natsumi! 🦋\nMeet Natsumi Browser (or Natsumi, for short) - a browser mod that truly puts you in control.\n\nNatsumi Browser (or Natsumi, for short) is a skin made for Firefox and its forks that adds lots of\npolish to the design and adds new features to further enhance the browsing experience, while retaining\ncustomization options to allow you to fully make things yours.\n\nDespite the name, Natsumi is NOT a standalone browser - it's meant to be applied on top of your\nfavorite Firefox-based browser!\n\n## Features\nNatsumi has lots of features to enhance your browser - so many that I can't list them all here!\n\n### ✨ Reimagined design. Fully customizable.\n#### The classic Firefox design but with a modern yet customizable spin.\n![](./images/custom-themes.webp)\n\nNatsumi keeps your browser's design familiar while adding a modern touch to it. Not only that, it's\nalso **extremely customizable**, so you can make it truly yours. No \"best practices\" or authoritarian\ndesign ideologies to stop you, just a browser that works with you and not against you.\n\nAlmost all customization options are accessible through a dedicated preferences pane, so you don't\nhave to mess around with advanced preferences.\n\n### ⌨️ URL bar, made intuitive.\n#### Highlights the current URL and adapts to the scene.\n![](./images/urlbar.webp)\n\nNatsumi applies a fresh new coat of paint to your browser's URL bar, making the current URL stand out\nmore and changing colors dynamically based on context.\n\n### 🖥️ Reimagined Picture-in-picture.\n#### Modern and streamlined.\n\n![](./images/pip-movement.webp)\n\nNatsumi's Picture-in-picture adds a more modern look to Firefox's PiP to make it more consistent with\nthe rest of the browser. You can even scroll to reposition the PiP window, too!\n\n### 🎛️ Meet your Miniplayer.\n#### Keep your media in control.\n![](./images/miniplayer.webp)\n\nNatsumi lets you control your media through the Miniplayer located on the sidebar. And with support\nfor multiple websites at a time, you don't have to make your tabs fight for a spot.\n\n### 📄 PDF viewer, modernized.\n#### View your documents in the 21st century.\n\n![](./images/pdf-viewer.webp)\n\nGive Firefox's PDF viewer a fresh coat of paint! Natsumi includes tweaks for the default PDF viewer,\ngiving it the modern look it really deserves. And with compact view, you can focus on the file at\nhand when you don't need the extra tools.\n\n### 🧘 Featuring Single Toolbar.\n#### Go minimal or go utility-first, it's your choice.\n![](./images/single-toolbar.webp)\n\nNot a fan of multiple toolbars? Craving more horizontal space? Natsumi adds it to your browser of\nchoice.\n\nAnd of course, you can always use the Multiple Toolbars layout. Natsumi doesn't force things on you.\n\n### ⌨️ Customize your shortcuts.\n#### Featuring keyboard shortcut conflict controls.\n![](./images/shortcuts.webp)\n\nTake full control of your browser's keyboard shortcuts! Natsumi lets you customize your shortcuts\nto your likings and even lets you choose how it should handle shortcut conflicts between the browser\nand websites. No more being forced to show mercy to websites when shortcuts conflict.\n\n### 🍰 Additional browser-specific goodies.\n#### Get extra features custom-made for specific browsers.\n![](./images/floorp-features.webp)\n\nDoes your browser have Workspaces? Or another toolbar that can be used in the sidebar? Natsumi adds\nextra features to your browser for a more complete experience.\n\n## Full-fledged vs. CSS-only\nSome Natsumi features require JavaScript to work. You can still use Natsumi without JS support at the\ncost of losing some features.\n\n| Feature                            | Full (Natsumi + Natsumi Append) | CSS-only (Natsumi) |\n|------------------------------------|---------------------------------|--------------------|\n| Natsumi URLbar/Findbar             | :white_check_mark:              | :white_check_mark: |\n| Natsumi PDF Viewer                 | :white_check_mark:              | :white_check_mark: |\n| Natsumi PiP                        | :white_check_mark:              | :warning: Limited  |\n| Natsumi Miniplayer                 | :white_check_mark:              | :x:                |\n| Theming engine                     | :white_check_mark:              | :white_check_mark: |\n| Customize Natsumi preferences page | :white_check_mark:              | :x:                |\n| Custom themes                      | :white_check_mark:              | :x:                |\n| Single Toolbar                     | :white_check_mark:              | :x:                |\n| Compact Mode                       | :white_check_mark:              | :x:                |\n| Status bar as sidebar toolbar      | :white_check_mark:              | :x:                |\n| Natsumi Shortcuts                  | :white_check_mark:              | :x:                |\n\n\n## Installation\nYou will need to install Natsumi by copying its files to your profile's chrome folder.\n\n### Automatic install\n#### Installing via installer (macOS/Linux only)\nEvery release of Natsumi from v5 comes with an installer binary. You can run it to install Natsumi\nBrowser, Natsumi Browser Pages and Natsumi Append to your browser and profile of choice.\n\n\u003e [!NOTE]\n\u003e For macOS and Linux users, you may need to give the installer execute permissions before you can run the\n\u003e installer. You can run `chmod +x /path/to/installer` to give it the necessary permissions.\n\u003e \n\u003e For macOS users, you may also need to override the unsigned binary warning (also known as the \"Apple\n\u003e could not verify \"App\" is free of malware\" warning) by going to System Preferences =\u003e Security \u0026 Privacy\n\u003e after trying to run the installer.\n\n\u003e [!WARNING]\n\u003e For Flatpak installations, you will need to manually install Natsumi to make it functional. See **Manual\n\u003e Install** for more details.\n\n#### Installing via installer (Windows only)\nDownload and run `windows-installer.bat` as Admin and follow the on-screen prompts. \n\nYou can get this file from the `Installers` folder in this repo.\n\n\u003e [!NOTE]\n\u003e The Windows installer needs to run as Admin so it can copy the needed files to the correct system locations.\n\u003e To update Natsumi on Windows, run the `windows-installer.bat` again with your browser closed.\n\n#### Installing via Sine\n\u003e [!WARNING]\n\u003e Installing via Sine is supported but not recommended.\n\nYou can install Natsumi and Natsumi Append through [Sine](https://github.com/CosmoCreeper/Sine).\n\n### Manual install\nRemember to take backups of your userChrome.css and userContent.css files before proceeding!\n\n#### Installing Natsumi Browser and Natsumi Browser Pages\n1. Copy natsumi-config.css, userChrome.css, userContent.css and natsumi folder to your chrome folder.\n2. That's it - Natsumi (CSS-only) is installed!\n\n#### Installing Natsumi Append (optional)\nInstalling Natsumi Append allows you to use the full feature set of Natsumi Browser, but it's not\nrequired for the core parts of Natsumi to work.\n\nNatsumi Browser needs to be installed before you can install Natsumi Append.\n\n1. Install [fx-autoconfig](https://github.com/MrOtherGuy/fx-autoconfig) to your browser. You need to\n   install the contents of both program and profile/chrome, follow the instructions in the fx-autoconfig\n   repository.\n\n   **Note**: The guide doesn't mention the module_loader.mjs file, but you'll need this for fx-autoconfig\n   to work. Otherwise, Natsumi's modules will show in your scripts but won't actually be loaded.\n\n   **Flatpak users**: You may need to follow steps 1 and 2 on\n   [here](https://github.com/MrOtherGuy/fx-autoconfig/issues/48#issuecomment-3315929253), but replace\n   `app.zen_browser.zen` with the package identifier of your browser (e.g. `one.ablaze.floorp`).\n2. Copy the following to chrome/utils/chrome.manifest:\n   ```\n   content userchromejs ./\n   content userscripts ../natsumi/scripts/\n   skin userstyles classic/1.0 ../CSS/\n   content userchrome ../resources/\n   content natsumi ../natsumi/\n   content natsumi-icons ../natsumi/icons/\n   ```\n3. Create and enable `userChromeJS.persistent_domcontent_callback` before restarting (don't worry, you\n   can do this later. This config is needed for the preferences page to work.)\n4. Go to about:support and clear your startup cache and restart your browser (this may not be required but\n   it is still recommended).\n5. That's it - Natsumi Append is installed!\n\n#### Advanced setup: If you are a techie who wants to keep your files up-to-date with new changes over time\nAfter following either of the above steps, if you are interested in ensuring that you upgrade to the\nlatest version of Natsumi as new changes are released, you can simply clone the repository into the `chrome`\nfolder. This can be followed up with `git pull` from time-to-time.\n\n## Browser configs (in about:config)\n\u003e [!NOTE]\n\u003e This is a non-exhaustive list. Most of these options are available in preferences.\n\nThese are the configs you can use to tweak Natsumi Browser. If you want to tweak the animation duration\nand delay, change the variables in the config.css file.\n\nIf you have Natsumi Append installed, most of these can be tweaked through the preferences page.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eView configs\u003c/strong\u003e\u003c/summary\u003e\n\n### 🎨 Theming/General\n- `natsumi.theme.type` (string): Sets the browser theme type.\n  - **Default** (default) - No changes, just the default look.\n  - **Gradient** (`gradient`) - A light gradient of your accent color.\n  - **Complementary Gradient** (`gradient-complementary`) - A gradient of the accent color and its opposite color.\n  - **Colorful Solid** (`colorful`) - A solid color with a tint of the accent color.\n  - **Playful Solid** (`playful`) - A higher contrast version of Colorful Solid.\n  - **Lucid** (`lucid`) - A recreation of the Zen Dream and Zen Galaxy themes.\n  - **Frutiger Aero** (`frutiger-aero`) - A Windows Vista/7-like design.\n  - **OLED** (`oled`) - A completely black and white theme for the minimalists.\n  - **🏳️‍🌈 LGBTQ+** (`lgbtq`) - Browsing with pride!\n  - **🏳️‍⚧️ Transgender** (`transgender`) - Trans rights are human rights!\n  - **Custom** (`custom`) - Create your own theme (in the preferences page)!\n- `natsumi.theme.accent-color` (string): Sets the browser theme color from a given accent color.\n  - $${\\color{#a0d490}■}$$ **Light green** (default) - #a0d490\n  - $${\\color{#aac7ff}■}$$ **Sky blue** (`sky-blue`) - #aac7ff\n  - $${\\color{#74d7cb}■}$$ **Turquoise** (`turquoise`) - #74d7cb\n  - $${\\color{#dec663}■}$$ **Yellow** (`yellow`) - #dec663\n  - $${\\color{#ffb787}■}$$ **Peach Orange** (`peach-orange`) - #ffb787\n  - $${\\color{#ff9eb3}■}$$ **Warmer Pink** (`warmer-pink`) - #ff9eb3\n  - $${\\color{#dec1b1}■}$$ **Beige** (`beige`) - #dec1b1\n  - $${\\color{#ffb1c0}■}$$ **Light Red** (`light-red`) - #ffb1c0\n  - $${\\color{#ddbcf3}■}$$ **Muted Pink** (`muted-pink`) - #ddbcf3\n  - $${\\color{#f6b0ea}■}$$ **Pink** (`pink`) - #f6b0ea\n  - $${\\color{#d4bbff}■}$$ **Lavender Purple** (`lavender-purple`) - #d4bbff\n  - $${\\color{#ffffff}■}$$ **System Accent** (`system`) - uses your system's accent color\n- `natsumi.theme.force-natsumi-color` (boolean): Forces Natsumi's accent color set in natsumi-config.css\n  to be used instead of the current Firefox theme's colors.\n- `natsumi.theme.use-tab-theme-color` (boolean): Uses the tab border color as the accent color for Blade.\n  This may break Blade on some themes.\n- `natsumi.theme.max-custom-colors` (integer): The maximum number of custom colors you can choose. Minimum\n  and default is 6.\n- `natsumi.theme.disable-translucency` (boolean): Disables the translucency effect.\n- `natsumi.theme.use-legacy-translucency` (boolean): Uses legacy translucency on macOS or Windows.\n- `natsumi.theme.gray-out-when-inactive` (boolean): Grays out the browser when inactive.\n- `natsumi.theme.single-toolbar` (boolean): Enables Single Toolbar layout.\n- `natsumi.theme.single-toolbar-show-menu-button` (boolean): Shows the menu button when in Single Toolbar.\n- `natsumi.theme.single-toolbar-hide-extensions-button` (boolean): Hides the extensions button when in\n  Single Toolbar.\n- `natsumi.theme.show-bookmarks-on-hover` (boolean): Shows the bookmarks bar on hover when in Single\n  Toolbar.\n- `natsumi.theme.compact-marginless` (boolean): Removes the frame around the website content when in \n  compact mode.\n- `natsumi.theme.compact-on-new-window` (boolean): Enables Compact Mode by default for new windows.\n- `natsumi.theme.compact-style` (string): Sets the Compact Mode style.\n  - `default` (Hide both): Hides both the toolbar and sidebar.\n  - `toolbar` (Hide toolbar): Hides only the toolbar.\n  - `sidebar` (Hide sidebar): Hides only the sidebar.\n- `natsumi.theme.force-window-controls-to-left` (boolean): Forces window controls to the sidebar rather\n  than the bookmarks bar.\n- `natsumi.theme.classic-preferences` (boolean): Disables Natsumi's preference page theming.\n- `natsumi.theme.floorp-hide-preferences-warnings` (boolean): Hides Floorp Hub warnings on the preferences\n  page. **Floorp exclusive.**\n- `natsumi.theme.icons` (string): Sets the icon pack used in Natsumi.\n  - `default` (Firefox default): Default Firefox icons.\n  - `lucide`: Lucide icons.\n  - `fluent`: Fluent UI Icons.\n- `natsumi.theme.icons-alt-back-forward` (boolean): Uses alternative back/forward icons.\n- `natsumi.theme.ignore-css-issues`: Ignores CSS issues and prevents the CSS warning from showing up.\n\n### 🗂️ Tabs \u0026 Sidebar\n- `natsumi.tabs.use-custom-type` (boolean): Enables custom tab types. Blade is used when this is disabled.\n- `natsumi.tabs.type` (string): Sets a custom tab type. `natsumi.tabs.use-custom-type`\n  - `default` (Blade): A modern and sleek, yet dynamic tab design.\n  - `origin`: A box-like design inspired by Natsumi v1.\n  - `curve`: A curve-like design inspired by Natsumi v2.\n  - `fusion`: A Lepton-like design that 'combines' tab and web content.\n  - `material`: A material-like design inspired by Zen Browser's alpha UI.\n  - `hexagonal`: A tab design inspired by Floorp's hexagonal branding.\n  - `classic`: Just the standard Firefox look.\n- `natsumi.tabs.blade-legacy-color` (boolean): Uses the legacy Blade tab highlight color like in v5 and\n  older.\n- `natsumi.tabs.fusion-highlight` (boolean): Adds a Photon (Firefox Quantum)-like highlight to the active\n  tab for Fusion tab design.\n- `natsumi.tabs.material-alt-design` (boolean): Uses an alternative design for Material tab design, similar\n  to the toolbar buttons design in Natsumi.\n- `natsumi.tabs.new-tab-on-top` (boolean): Moves the new tab button to the top of the tabs list.\n- `natsumi.tabs.replace-new-tab` (boolean): Removes the New Tab entirely and opens the URL bar instead.\n- `natsumi.tabs.workspace-specific-pins` (boolean): Makes pinned tabs specific to each workspace. **Floorp \n  exclusive.**\n- `natsumi.sidebar.hide-clear-tabs` (boolean): Disables the clear unpinned tabs button.\n- `natsumi.sidebar.clear-keep-selected` (boolean): Keeps selected tabs when clearing unpinned tabs.\n- `natsumi.sidebar.clear-merge-with-workspaces` (boolean): Merges the clear unpinned tabs button with the\n  Workspace indicator. **Floorp exclusive.**\n- `natsumi.sidebar.clear-open-newtab` (boolean): Opens a new tab after clearing unpinned tabs.\n- `natsumi.sidebar.disable-clickable-workspace-icons` (boolean): Disables clickable workspace icons when\n  the workspaces toolbar button is set to display as an icons strip. **Floorp exclusive.**\n- `natsumi.sidebar.floorp-floating-panel`: Floats the Panel Sidebar similar to Compact Mode. **Floorp\n  exclusive.**\n- `natsumi.sidebar.hide-sidebar-controls` (boolean): Hides sidebar controls.\n- `natsumi.sidebar.use-statusbar-in-sidebar` (boolean): Uses Floorp or Waterfox's Status Bar as a toolbar\n  for the sidebar when the Status Bar is \"hidden\". **Floorp and Waterfox exclusive.**\n- `natsumi.sidebar.hide-workspace-indicator` (boolean): Hides the Floorp Workspace indicator added by\n  Natsumi. **Floorp exclusive.**\n- `natsumi.sidebar.legacy-workspace-indicator` (boolean): Uses the legacy Workspace indicator. Use this if\n  the indicator is misbehaving. **Floorp exclusive.**\n- `natsumi.sidebar.workspaces-as-icons` (boolean): Displays the Floorp Workspaces toolbar button as an icons\n  strip. **Floorp exclusive.**\n\n### ⌨️ URL bar\n- `natsumi.urlbar.disabled` (boolean): Disables URL bar tweaks.\n- `natsumi.urlbar.do-not-float` (boolean): Disables the floating URL bar.\n- `natsumi.urlbar.always-expanded` (boolean): Disables the compact URL bar when inactive.\n- `natsumi.urlbar.single-toolbar-display-actions` (boolean): Displays URL bar actions when in Single\n  Toolbar.\n\n### 🔎 Findbar\n- `natsumi.findbar.disabled` (boolean): Disables Natsumi Findbar and reverts the findbar style back.\n- `natsumi.findbar.disable-not-found-bg` (boolean): Disables red background that appears when there are no\n  results.\n- `natsumi.findbar.wider-findbar` (boolean): Increases maximum Findbar width back to 720px.\n\n### 🎛️ Miniplayer\n- `natsumi.miniplayer.disable-artwork` (boolean): Disables the artwork from showing in the Miniplayer.\n- `natsumi.miniplayer.scroll-view` (boolean): Sets the Miniplayer list to be scrollable.\n\n### 👀 Glimpse\n- `natsumi.glimpse.enabled` (boolean): Enables Natsumi Glimpse.\n- `natsumi.glimpse.multi` (boolean): Enables Multi Glimpse. Required for Glimpse Chaining.\n- `natsumi.glimpse.key` (string): Sets the activation method for Glimpse.\n  - `alt`: Alt key\n  - `ctrl`: Ctrl key\n  - `meta`: Meta (Command/Super) key\n  - `shift`: Shift key\n  - `hold`: Hold (click and hold)\n- `natsumi.glimpse.controls-on-right` (boolean): Moves Glimpse controls to the right.\n- `natsumi.glimpse.alt-border` (boolean): Uses an alternative border color to highlight Glimpse tabs more.\n- `natsumi.glimpse.show-indicator` (boolean): Shows a Glimpse indicator right above the Glimpse tab.\n\n### 🖥️ Picture-in-Picture\n- `natsumi.pip.disabled` (boolean): Disables Natsumi PiP and reverts the PiP style back.\n- `natsumi.pip.disable-scroll-to-move` (boolean): Disables the ability to scroll to move the PiP window.\n- `natsumi.pip.legacy-style`: Merges PiP controls into one \"island\" like in Natsumi v3.\n- `natsumi.pdfjs.material` (string): Sets the material used in the PiP elements. Haze is used when this is\n  unset.\n    - `haze`: Haze\n    - `tinted-haze`: Tinted Haze\n- `natsumi.pip.rounded` (boolean): Makes the PiP window round, like in macOS. Only supports Windows.\n\n### 📄 PDF Viewer\n- `natsumi.pdfjs.disabled` (boolean): Disables Natsumi PDF Viewer and reverts the PDF viewer back.\n- `natsumi.pdfjs.compact` (boolean): Enables toolbar autohide for Natsumi PDF Viewer.\n- `natsumi.pdfjs.compact-dynamic` (boolean): Disables toolbar autohide when the PDF Viewer's sidebar is\n  expanded.\n- `natsumi.pdfjs.material` (string): Sets the material used in the PDF viewer elements. Haze is used when\n  this is unset.\n  - `haze`: Haze\n  - `tinted-haze`: Tinted Haze\n\n### 🏠 Firefox Home\n- `natsumi.home.disabled` (boolean): Disables Natsumi FF home and reverts the FF home page back.\n- `natsumi.home.custom-background` (boolean): Uses the custom background set in config as the home \n  screen background.\n\n### 🔧 Compatibility\n- `natsumi.browser.type` (string): Sets the browser type to enable browser-exclusive features and patches.\n  **If you use Natsumi Append, this preference will be automatically set.**\n  - `firefox`: Mozilla Firefox\n  - `floorp`: Floorp Browser\n  - `waterfox`: Waterfox\n  - `librewolf`: Librewolf\n  - `tor`: Tor Browser\n  - `mullvad`: Mullvad Browser\n  - `firedragon`: FireDragon\n- `natsumi.browser.disable-auto-detect` (boolean): Disables automatic browser detection. Use this if you\n  need to manually set the browser type. **Requires restart to take effect.**\n\u003c/details\u003e\n\n## Browser support\nAll browsers must be based on Firefox 140 or above.\n\n| Browser     | Status                       | Versions | Notes                                                                                     |\n|-------------|------------------------------|----------|-------------------------------------------------------------------------------------------|\n| Floorp      | :star: Recommended           | 12.3.0+  | Natsumi works best on Floorp!                                                             |\n| Firefox     | :white_check_mark: Supported | 140+     |                                                                                           |\n| Waterfox    | :white_check_mark: Supported | 6.6.0+   |                                                                                           |\n| Librewolf   | :white_check_mark: Supported | 140+     |                                                                                           |\n| Mullvad/Tor | :white_check_mark: Supported | 15.0+    | **Tor does not recommend installing plugins onto Tor Browser.** Proceed at your own risk. |\n| FireDragon  | :white_check_mark: Supported | 12+      | Default Sweet-Dark theme may cause contrast issues with Natsumi.                          |\n| Glide       | :white_check_mark: Supported | 0.1.54a+ |                                                                                           |\n| Midori      | :x: Unsupported              | -        | Incompatible (see FAQ)                                                                    |\n| Zen         | :x: Unsupported              | -        | Incompatible since Natsumi v4 (see FAQ)                                                   |\n\n## FAQs\n### \"Does Natsumi support the new Firefox Nova redesign?\"\nYes (sort of) - Natsumi is compatible with the current spec for **Firefox 153**.\n\nFirefox Nova is still in early development and constantly changing. Each Natsumi release will aim to\naddress these changes, so that once Firefox Nova is complete and rolled out, Natsumi will be\n**Firefox Nova-ready from day one** while being fully backwards compatible with the old Proton design\nfor older supported versions.\n\n### \"Can I disable individual features?\"\nYou can disable some features using the configuration options.\n\nIf that doesn't help, you can remove certain modules (CSS files) from the natsumi.css file. However,\nyou will need to keep certain files (preload, postload, natsumi-config) for Natsumi to work properly.\n\n\u003e [!CAUTION]\n\u003e By modifying any part of Natsumi, you are responsible for any issues that may arise. If things do\n\u003e break, I will most likely not offer support for it.\n\u003e \n\u003e If you installed Natsumi as part of another skin, your installation may be considered modified.\n\u003e Please check with the skin's developer for assistance in this case.\n\n### \"Why is Natsumi not compatible with Zen Browser or Midori Browser?\"\nZen Browser and Midori Browser are not supported due to a hostile stance on personalization (among\nsome other issues) and ethical issues respectively.\n\n**Please do not try to port Natsumi to either of these browsers.** I have my reasons why I left\nthese browsers unsupported, so I would really appreciate it if you respected my decision.\n\n### \"I don't like the design, please change it!\"\nAlthough Natsumi is designed to be as customizable as possible, there may be some opinionated\ndesign choices that I may not change. In the end, Natsumi is still my personal browser skin.\n\nIf you would like me to add options for certain aspects of the browser, please open a feature request\nand I will consider it.\n\n### \"Can I use your code for my browser?\"\nIf your browser is open-source and licensed under the GPLv3 or later (or AGPLv3 or later), then yes.\nOtherwise, please contact me.\n\n### \"Why is userChrome.css so empty?\"\nSome browser mods may put all of their CSS code in one giant userChrome.css file. However, Natsumi\ndoes not use this approach to separate code into separate files for the sake of organization.\n\nNatsumi Browser uses a system where the userChrome.css file acts as a loader that loads the skin,\ninstead of being the file that contains all rules. This way, it's easier for users to quickly enable\nand disable custom CSS.\n\n### \"mrrp\"\nmeow :3\n\n## Troubleshooting\n### \"URLbar blur won't work!\"\nMake sure both `layout.css.backdrop-filter.enabled` and `layout.css.backdrop-filter.force-enabled` are\nset to true. Also make sure that you're using WebRender and hardware rendering.\n\n### \"I don't see any of the Natsumi options in about:config!\"\nThese are custom options which you need to create. Type in the exact name, then press the plus button on\nthe right to create the config.\n\nYou can also access most of the configs through the browser preferences page if Natsumi Append is\ninstalled.\n\n### \"I don't see the Customize Natsumi option in the settings page!\"\nPlease check that you've installed fx-autoconfig and `userChromeJS.persistent_domcontent_callback` is\ntrue.\n\n### \"Natsumi looks very weird in Floorp/Waterfox!\"\nThis may be because you do not have the Proton design (i.e. the default Firefox design) enabled. Natsumi\nonly supports Proton and does not support other designs such as Lepton or Fluerial.\n\nYou can fix this by going to Floorp Hub =\u003e Tab \u0026 Appearance in Floorp or Look \u0026 Feel in Waterfox.\n\nIf you have Natsumi Append installed, Natsumi will automatically reset your tab design to Proton if\nyou're on Floorp.\n\n### \"I can't use custom skin X with Natsumi, please add support for it!\"\nThis is not something I am able to help with. Natsumi is not tested with other themes in mind, so it is\npossible that installing incompatible themes alongside Natsumi may break one or more of them.\n\n### \"Why is my browser showing as not recommended to be used with Natsumi?\"\nIf you're on browsers like Tor or Mullvad, you may be greeted with this message on first boot.\n\nThis means the developers of such browsers don't recommend use of plugins or any other modifications due\nto the high-security or/and privacy nature of the browser. You can still use Natsumi on these browsers,\nbut you do so at your own risk.\n\n### \"Why is my browser showing as not compatible with Natsumi?\"\n\u003e [!NOTE]\n\u003e This is for users seeing the compatibility warning after installing Natsumi. If you're wondering why\n\u003e the browser shows up as not compatible on the compatibility table, you may want to refer to the notes\n\u003e for each incompatible browser.\n\nIf you see this warning, it means Natsumi intentionally isn't supported on your browser due to serious\nconcerns or severe compatibility issues.\n\nWhen a browser's developers have stances that go against Natsumi's core values (especially regarding\nuser customization) or a browser is heavily modified from Firefox to the point that it basically doesn't\nuse Firefox's selectors, this can sometimes lead to me having to push out patches often just to address\nfeature restrictions, compatibility issues and so on. This is not sustainable for me as Natsumi's\ndeveloper, so I intentionally do not support such browsers out of caution.\n\nPlease consider using another compatible browser or uninstall Natsumi.\n\n### \"Something's bugged!\"\nThere may be userchromes that you're using alongside Natsumi Browser that breaks things. Please disable\nthese then try again.\n\nIf the issue still persists, open an issue or report the bug to the developer through Discord.\n\n## Acknowledgements\nThank you to:\n- [asev](https://github.com/lunar-os) for ZenCss, which served as the base for Natsumi Browser's base\n  CSS for v1\n- [vicky5124](https://github.com/vicky5124) for the Tab Groups CSS used until v2.4.0\n- [AlexCookieDev](https://github.com/AlexCookieDev) for inspiring some of the animations I used in Natsumi\n  v2 and v3\n- [InterstellarOne](https://github.com/InterstellarOne) for the Liquid Glass style Natsumi icons and the kawaii logo\n\n## Disclaimer\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT\nLIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO\nEVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR\nTHE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\nAll screenshots displayed in this README are accurate as of December 2, 2025. If a feature was added,\nchanged or removed after this date, it may not be accurately reflected in the screenshots.\n\n## Attribution\nNatsumi Browser uses code or files from other open-source projects. The original sources and their\nlicenses are listed below.\n\n\u003e [!NOTE]\n\u003e For icon packs attribution, please check the README and LICENSE files in the icons folder for the\n\u003e respective icon pack.\n\n- [MX-Linux/mx-sound-theme-borealis](https://github.com/MX-Linux/mx-sound-theme-borealis)/[Borealis](https://ico.bukvic.net/main/borealis/)\n  \n  License: GPLv3\n  \n  File used: `Borealis/stereo/desktop-login.ogg`, `Borealis/stereo/Exit1_2.ogg`, `Borealis/stereo/K3b_success.ogg`\n  \n  Changes made: none\n  \n- [MrOtherGuy/fx-autoconfig](https://github.com/MrOtherGuy/fx-autoconfig)\n\n  License: MPL-2.0\n\n  Files used: `program` (folder), `profile/chrome/CSS` (folder), `profile/chrome/utils` (folder), `profile/chrome/resources` (folder)\n\n  Changes made: Modified `profile/chrome/utils/chrome.manifest` (changes shown using diff formatting):\n  - ```diff\n    ...\n    - content userscripts ../JS/\n    + content userscripts ../natsumi/scripts/\n    ...\n    content userchrome ../resources/\n    + content natsumi ../natsumi/\n    + content natsumi-icons ../natsumi/icons/\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreeeen-dev%2Fnatsumi-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreeeen-dev%2Fnatsumi-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreeeen-dev%2Fnatsumi-browser/lists"}