{"id":17800901,"url":"https://github.com/refi64/cobalt","last_synced_at":"2025-03-17T10:34:21.783Z","repository":{"id":46802119,"uuid":"389227878","full_name":"refi64/cobalt","owner":"refi64","description":"ChOmium BootstrAp fLaTpaks","archived":false,"fork":false,"pushed_at":"2024-10-14T01:54:30.000Z","size":38,"stargazers_count":21,"open_issues_count":4,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-16T01:41:24.465Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/refi64.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":"2021-07-25T00:42:07.000Z","updated_at":"2024-10-13T16:51:18.000Z","dependencies_parsed_at":"2024-04-08T02:34:43.139Z","dependency_job_id":"b4c77b99-f7f0-4efc-88ff-8ca2bd8ef7b2","html_url":"https://github.com/refi64/cobalt","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refi64%2Fcobalt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refi64%2Fcobalt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refi64%2Fcobalt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refi64%2Fcobalt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/refi64","download_url":"https://codeload.github.com/refi64/cobalt/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243858668,"owners_count":20359395,"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":[],"created_at":"2024-10-27T12:32:31.640Z","updated_at":"2025-03-17T10:34:21.775Z","avatar_url":"https://github.com/refi64.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cobalt\n\n*\u003cb\u003eC\u003c/b\u003ehr\u003cb\u003eo\u003c/b\u003emium \u003cb\u003eB\u003c/b\u003eootstr\u003cb\u003ea\u003c/b\u003ep for F\u003cb\u003el\u003c/b\u003ea\u003cb\u003et\u003c/b\u003epaks*\n\nCobalt is a unified \"launcher\" for the various Chromium/Chrome-based Flatpaks,\nin order to avoid code duplication in their launcher scripts.\n\nCobalt follows a \"convention over configuration\" approach, and in most\ncases no configuration file at all, or a very short one, is needed for usage.\n\n## Flags\n\nCobalt also supports reading flags to pass to the browser on startup from\n`~/.var/app/APP_ID/config/NAME-flags.conf`, where `NAME` is the value of the\n`Name=` key in the config file (see below).\n\nEach line of `NAME-flags.conf` is a single flag to be passed to the browser,\nand lines starting with a `#` are treated as comments and skipped:\n\n```\n# This is a comment.\n\n# Our first flag:\n--disable-gpu\n# Our second flag:\n--ozone-backend=wayland\n```\n\nIn addition,  to enable and disable features, a special syntax is supported:\n`features+=FEATURE` and `features-=FEATURE`. Unlike `--enable-features=` and\n`--disable-features`, `features+=` and `features-=` are cumulative and thus do\n*not* clear out all the previous values. In other words, this will only enable\n`UseOzonePlatform`, as the second value *overwrites* the first:\n\n```\n--enable-features=VaapiVideoEncoder,VaapiVideoDecoder\n--enable-features=UseOzonePlatform\n```\n\nWhereas this results in all three features enabled:\n\n```\nfeatures+=VaapiVideoEncoder\nfeatures+=VaapiVideoDecoder\nfeatures+=UseOzonePlatform\n```\n\n## Debugging\n\nIf you're not sure why your configuration isn't working,\nsetting the variable `G_MESSAGES_DEBUG=cobalt` will print debugging information\non:\n\n- Default values inferred when not present in the config file.\n- Environment variables set.\n- The full command line of the browser being started.\n\n## Configuration file\n\nThe file, if needed, should go into `/app/etc/cobalt.ini`.\n\n```ini\n[Application]\n# The application's name, defaults to the last component of the app ID,\n# lowercased. For instance, given org.chromium.Chromium, the name will be set to\n# 'chromium'.\nName=brave\n\n# The actual entry point binary for the browser. This should point to the \"true\"\n# main executable binary, and not any wrapper scripts. If omitted, defaults to\n# whichever exists of \"/app/Name/Name\" or \"/app/extra/Name\", where \"Name\" is\nEntryPoint=/app/brave/brave\n\n# The \"wrapper script\" that the Flatpak uses. In other words, this is the\n# script that is run when the user clicks on the application icon, and then that\n# script is what starts Cobalt. If omitted, Cobalt will check your desktop file\n# and pull the script from there.\nWrapperScript=/app/bin/brave\n\n# The subdirectory under XDG_CONFIG_HOME that the browser stores its files in.\n# This has no default, and it only needs to be set if \"ExposeWidevine\" is set\n# below.\nConfigDir=BraveSoftware/Brave-Browser\n\n# A semicolon-separated list of URLs to show the first time the browser is\n# opened.\nFirstRunUrls=file:///app/share/flatpak-chrome/first_run.html\n\n# If your browser was previously using a flags file other than NAME-flags.conf,\n# you can set this to the old name to automatically migrate the flags within.\nMigrateFlagsFile=chrome-flags.conf\n\n# Flatpak 1.8+ comes with a feature known as 'expose-pids', which is used by\n# Zypak to run more efficiently. (Chromium Flatpaks that don't use Zypak, like\n# Chromium itself and Ungoogled Chromium, generally require this and won't start\n# without it.) The feature also depends on unprivileged user namespaces being\n# enabled on the host system. This option determines what to do if expose-pids\n# is not available:\n# - If \"required\", then an error dialog is shown to the user, and the\n#   application will not start.\n# - If \"recommended\", then a warning dialog will be shown to the user, and they\n#   can elect to never show it again.\n# - If \"optional\", then this will not be checked at all.\n# If omitted, this option will default to \"recommended\" if Zypak.Enabled is true\n# (see blow) and \"required\" if not.\nExposePids=recommended\n\n[Zypak]\n# If true, then zypak-wrapper.sh will be prepended to the command. If omitted,\n# it will be set to 'true' of zypak-wrapper.sh is present in the Flatpak.\nEnabled=true\n\n# Some Flatpaks have a different name for their sandbox binary. If so, you can\n# set it here. If omitted, the sandbox name will try to automatically be\n# detected by checking for either a 'chrome-sandbox', or 'NAME-sandbox', or\n# 'ENTRYPOINT-sandbox' (where NAME is the value of Application.Name, and\n# ENTRYPOINT is the last path component of Application.EntryPoint), all in the\n# EntryPoint's directory.\n# For more info, see: https://github.com/refi64/zypak#alternate-sandbox-binary-names\nSandboxFilename=chrome-sandbox\n\n# If true, then the directory at CONFIG_DIR/WIDEVINE_PATH will be exposed into\n# the sandbox so that Widevine can be loaded.\nExposeWidevine=true\n\n# Always defaults to WidevineCdm.\nWidevinePath=WidevineCdm\n\n[Flextop]\n# If true, 'flextop-init' will be called before starting the Flatpak. If omitted,\n# it will be set to 'true' if flextop-init is present in the Flatpak.\nEnabled=true\n\n# This lets you enable or disable some Chromium features by default. Each value\n# is a semicolon-separated list of features to enable/disable.\n[DefaultFeatures]\nEnabled=EnablePipeWireRTCCapturer\nDisabled=EnablePipeWireRTCCapturer\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefi64%2Fcobalt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frefi64%2Fcobalt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefi64%2Fcobalt/lists"}