{"id":22573193,"url":"https://github.com/morgant/ffssb2mlvwmrc","last_synced_at":"2025-03-28T15:12:41.761Z","repository":{"id":259078830,"uuid":"865131240","full_name":"morgant/ffssb2mlvwmrc","owner":"morgant","description":"Generate MLVWM (Macintosh-Like Virtual Window Manager) mlvwmrc application styles for Firefox SSBs (Site-Specific Browsers) ","archived":false,"fork":false,"pushed_at":"2024-10-26T20:23:58.000Z","size":10,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T00:39:22.911Z","etag":null,"topics":["ffssb","mlvwm","mlvwmrc","styles","utility-scripts"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/morgant.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":"2024-09-30T03:05:33.000Z","updated_at":"2024-10-26T20:24:02.000Z","dependencies_parsed_at":"2024-10-22T08:45:55.043Z","dependency_job_id":null,"html_url":"https://github.com/morgant/ffssb2mlvwmrc","commit_stats":null,"previous_names":["morgant/ffssb2mlvwmrc"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fffssb2mlvwmrc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fffssb2mlvwmrc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fffssb2mlvwmrc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fffssb2mlvwmrc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/morgant","download_url":"https://codeload.github.com/morgant/ffssb2mlvwmrc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246049631,"owners_count":20715511,"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":["ffssb","mlvwm","mlvwmrc","styles","utility-scripts"],"created_at":"2024-12-08T02:14:15.244Z","updated_at":"2025-03-28T15:12:41.737Z","avatar_url":"https://github.com/morgant.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ffssb2mlvwmrc\nby Morgan Aldridge \u003cmorgant@makkintosshu.com\u003e\n\n## OVERVIEW\n\nThis is a small utility to generate [MLVWM](https://github.com/morgant/mlvwm) application styles (specifically [`mlvwmrc`](https://github.com/morgant/mlvwmrc)) for [Firefox](https://www.mozilla.org/firefox/) SSBs (Site-Specific Browsers) which have been created using [Sebastian Appler's `ffssb`](https://github.com/sebastianappler/ffssb).\n\n**Important:** _This utility is in early testing. Please back up your data, especially your `~/.mlvwm/` configs, before using this!_\n\n`ffssb2mlvwmrc` generates an `~/.mlvwm/apps/ffssb/` directory containing:\n\n* One application styles file per FFSSB, especially:\n    * The FFSSB's name\n    * The FFSSB's icon or the Firefox icon\n    * The Firefox menus and other styles\n* An `.AppsManifest` which includes a `Read` command for each of the aforementioned FFSSB-specific files\n* An `.AppsMenu` which contains a `Menu...END` configuration block with menu items for all of the FFSSBs\n\nIt will also:\n\n1. Confirm that the generated `~/mlvwm/apps/ffssb/.AppsManifest` file is included in your main `~/mlvwm/apps/.AppsManifest` file\n2. Output basic instructions for including the generated `~/.mlvwm/apps/ffssb/.AppsMenu` and adding a `SubMenu ...` configuration line to one of your `Menu...END` blocks\n\n## PREREQUISITES\n\n* [MLVWM](https://github.com/morgant/mlvwm)\n* [`mlvwmrc`](https://github.com/morgant/mlvwmrc)\n* [`ffssb`](https://github.com/sebastianappler/ffssb)\n* [ImageMagick](https://imagemagick.org/)\n\n## INSTALLATION\n\n```\nmake install\n```\n\n## USAGE\n\nYou must have created at least one FFSSB using `ffssb`. You can confirm this by listing your FFSSBs:\n\n```\nffssb list\n```\n\n### First Run\n\nIf you've never used `ffssb2mlvwmrc` before and don't have any `~/.mlvwm/apps/ffsb/` or `~/.mlvwm/pixmap/ffssb/` directories, you can:\n\n1. Execute `ffssb2mlvwmrc` to create FFSSB application styles, icons, and a manifest file:\n    ```\n    ffssb2mlvwmrc\n    ```\n2. Add your newly created FFSSB applications manifest to your main `mlvwmrc` applications manifest file. You can do this by editing `~/.mlvwm/apps/.AppsManifest` and adding the following line:\n    ```\n    Read .mlvwm/apps/ffssb/.AppsManifest\n    ```\n3. Restart `mlvwm` to reload your configurations \u0026 application styles\n\n### Regenerating Application Styles\n\nIf you've previously used `ffssb2mlvwmrc` to create FFSSB application styles et al, but you've since updated your FFSSBs, I suggest updating them as follows:\n\n1. Move your existing `~/.mlvwm/apps/ffssb/` directory aside:\n    ```\n    mv ~/.mlvwm/apps/ffssb{,.$(date +%Y%m%d-%H%M%S)}\n    ```\n2. Execute `ffssb2mlvwmrc` to create new applications, styles, icons, and manifest file in `~/.mlvwm/apps/ffssb/`:\n    ```\n    ffssb2mlvwmrc\n    ```\n3. Restart `mlvwm` to reload your configurations \u0026 application styles\n\n### Adding a Submenu to a Menu\n\nAfter generating/regenerating FFSSBs application styles by executing `ffssb2mlvwmrc` (see above), you can also insert a submenu into the menu of your choice, listing all your FFSSBs, for quick launch. For example, you might add it to your `theme/*` files as follows:\n\n1. Back up your existing `~/.mlvwm/themes/` directory:\n    ```\n    cp -R ~/.mlvwm/themes{,.$(date +%Y%m%d-%H%M%S)}\n    ```\n2. Edit one of the `~/.mlvwm/themes/*` files (for example, `System7`)\n3. Above the line containing `Menu Apple, ...`, add the following line:\n    ```\n    Read .mlvwm/apps/ffssb/.AppsMenu\n    ```\n4. After the line containing `Menu Apple, ...` and before the nearest line containing `END`, add the following line:\n    ```\n    \"FFSSBs\" SubMenu FFSSB-FFSSBs, Icon folder.xpm\n    ```\n5. Save your changes\n6. Restart `mlvwm` to reload your configurations \u0026 application styles\n\n## LICENSE\n\nReleased under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorgant%2Fffssb2mlvwmrc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmorgant%2Fffssb2mlvwmrc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorgant%2Fffssb2mlvwmrc/lists"}