{"id":13477667,"url":"https://github.com/thepante/SAL-Firefox","last_synced_at":"2025-03-27T06:30:44.488Z","repository":{"id":124353247,"uuid":"245032868","full_name":"thepante/SAL-Firefox","owner":"thepante","description":"Sidebar Always Loaded for Firefox","archived":false,"fork":false,"pushed_at":"2021-06-19T16:22:12.000Z","size":54,"stargazers_count":15,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T02:38:31.084Z","etag":null,"topics":["firefox","floating","panel","script","shortcut","sidebar","userchrome"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thepante.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-03-05T00:26:38.000Z","updated_at":"2025-03-12T18:01:26.000Z","dependencies_parsed_at":"2024-01-14T08:14:11.692Z","dependency_job_id":"a344fc94-49a0-4d26-8530-8423944cc503","html_url":"https://github.com/thepante/SAL-Firefox","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepante%2FSAL-Firefox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepante%2FSAL-Firefox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepante%2FSAL-Firefox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepante%2FSAL-Firefox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thepante","download_url":"https://codeload.github.com/thepante/SAL-Firefox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245797192,"owners_count":20673805,"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":["firefox","floating","panel","script","shortcut","sidebar","userchrome"],"created_at":"2024-07-31T16:01:45.891Z","updated_at":"2025-03-27T06:30:44.183Z","avatar_url":"https://github.com/thepante.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","firefox"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://imgur.com/a/KnstI16\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://i.imgur.com/lnIsbhN.gif\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Sidebar Always Loaded\nThis script makes the sidebar to be always been ready to show its content, without the need to load it again each time we open the sidebar panel. The panel is just hiding, but without discard its content.\n\n\u003e Firefox default behavior is that each time you open the sidebar the content has to load again.\n\n**It has two visual modes:**\n- Float (default): the sidebar is floating over the tab content. Has options to customize it.\n- [Classic](https://i.imgur.com/F1StTk6.gif): Firefox's default look. Tab content and sidebar content shares the window's space.\n\n[**Check out a short demo video**](https://imgur.com/a/KnstI16)\n\n* Any addon (eg: Tree Style Tab) doesn't need to load every time you open the sidebar.\n* Bookmarks or history panels doesn't \"lost position\". You can search for something there, open a folder or whatever, then close the sidebar and open it again, you'll see that the panel is displaying the same content as when you closed it.\n\n## Sidebar shortcut\nIt has the option to set a keybind to open and close the sidebar.\n\nWithin this functionality there's a plus: Auto close. If the shortcut functionality and auto close are enabled, you can press the modifier (\u003ckbd\u003ectrl\u003c/kbd\u003e by default) and click somewhere inside the sidebar content and it will close.\n\nFor example, that is useful for switching tabs: (I have tabs on the sidebar) I open it with the shortcut and keep pressing \u003ckbd\u003ectrl\u003c/kbd\u003e to click a tab to swith to. The sidebar closes and I'm in the clicked tab without having to press the shortcut key combo again.\n\n## How to install it\n**Note that it requires to have an user script loader:** [You can check the steps here](https://github.com/thepante/setup/wiki/How-to-use-Firefox-'userChrome'-scripts).\n1. [**Download salf-userchrome.zip**](https://github.com/thepante/SAL-Firefox/releases/latest/download/salf-userchrome.zip)\n2. Copy the file `salf.uc.js` to your profile's `chrome` folder\n3. Restart Firefox\n\n\u003e **Note:** `chrome` its a folder that the user can use to customize the Firefox interface. [Read more here](http://kb.mozillazine.org/index.php?title=UserChrome.css).\nIf you don't have it, just create that. It is located inside your Firefox profile folder:\n\n\u003e In your Firefox address bar type and enter to `about:support`. There is 'Profile Directory' information, click 'Open Directory'. That's where the `chrome` folder should be located at.\n\nRestart Firefox: `about:profiles` → `Restart normally`\n\n## Preferences\nIf float mode is not enabled, then it is activated the \"classic\" mode, which is the (visually) Firefox default behavior. It does not discard its contents but the UI preferences are handled by the browser itself. That's mean that the \"float mode settings\" of this script are just for that floating mode.\n\n### Sidebar header\nYou can hide it by toggling the `hide_sidebar_header` constant to `true`. This just like the shortcut preferences, are not mode specific so it works on both classic and float modes.\n\n### Shortcut preferences\n\n| option      | type       | default value  | values\n| :---        | ---:       | ---:           | :--- |\n| enabled     | `Boolean`  | `false`        | `true`, `false`\n| modifier    | `String`   | `ctrl`         | `ctrl`, `alt`, `shift`, `meta`\n| key         | `String`   | `e`            | [any valid key](https://gist.github.com/thepante/2a72d4937f076dc6704ed0fbb3a4ca0c)\n| auto_close  | `Boolean`  | `true`         | `true`, `false`\n\nWith those default values (if enabled) the sidebar toggles visibility by pressing \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003ee\u003c/kbd\u003e.\n\n### Float mode specific settings\n\n| option       | type      | default value  | values\n| :---         | ---:      | ---:           | :--- |\n| enabled      | `Boolean` | `true`         | `true`, `false`\n| width        | `String`  | `280px`        | CSS units (`px`, `em`, `%`, etc)\n| height       | `String`  | `100%`         | CSS units (`px`, `em`, `%`, etc)\n| position     | `String`  | `right`        | `left`, `right`\n| shadow_intst | `Number`  | `0.12`         | `0` to `1`\n| transparent* | `Boolean` | `false`        | `true`, `false`\n| slide        | `Boolean` | `true`         | `true`, `false`\n| fade         | `Boolean` | `true`         | `true`, `false`\n| speed        | `Number`  | `0.1`          | seconds\n\nNote that `fade` and `speed` preferences are specific for the sliding (`slide`) effect.\n\n\\* `Transparent` option has blurred background, which uses the [`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter) property:\n\u003e From version 70 this feature is behind `thelayout.css.backdrop-filter.enabled` and the `gfx.webrender.all` preferences (both needs to be set to `true`). To change those preferences, visit `about:config`.\n\n---\n\n## Note\n**This script was made under Firefox version 89.0a1 (Nightly, 2021-04-08).**\u003cbr\u003e\nIf in a previous versions doesn't work, [try this previous script](https://github.com/thepante/SAL-Firefox/releases/tag/2.5) instead (only classic mode; [readme](https://github.com/thepante/SAL-Firefox/tree/2.5)).\n\n\nThis is a rework of my other script [alfs](https://github.com/thepante/alfs-firefox). That one didn't work anymore in newer versions of Firefox, so I had to redo it. At first, this one didn't had the floating mode so hadn't sense to be in that repo with \"floating\" in its name.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthepante%2FSAL-Firefox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthepante%2FSAL-Firefox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthepante%2FSAL-Firefox/lists"}