{"id":26116925,"url":"https://github.com/saml-dev/hammerflow.spoon","last_synced_at":"2026-04-20T17:02:47.849Z","repository":{"id":276730725,"uuid":"930105697","full_name":"saml-dev/Hammerflow.spoon","owner":"saml-dev","description":"A spoon to enable a global leader key for your Mac.","archived":false,"fork":false,"pushed_at":"2025-03-09T23:41:25.000Z","size":73,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-10T00:23:41.136Z","etag":null,"topics":["mac","macos","productivity"],"latest_commit_sha":null,"homepage":"https://hammerflow.dev","language":"Lua","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/saml-dev.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-10T04:36:23.000Z","updated_at":"2025-03-09T23:41:28.000Z","dependencies_parsed_at":"2025-03-10T00:35:38.382Z","dependency_job_id":null,"html_url":"https://github.com/saml-dev/Hammerflow.spoon","commit_stats":null,"previous_names":["saml-dev/hammerspoon-config","saml-dev/hammerflow","saml-dev/hammerflow.spoon"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saml-dev%2FHammerflow.spoon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saml-dev%2FHammerflow.spoon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saml-dev%2FHammerflow.spoon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saml-dev%2FHammerflow.spoon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saml-dev","download_url":"https://codeload.github.com/saml-dev/Hammerflow.spoon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242830506,"owners_count":20192200,"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":["mac","macos","productivity"],"created_at":"2025-03-10T10:22:53.549Z","updated_at":"2026-04-20T17:02:47.842Z","avatar_url":"https://github.com/saml-dev.png","language":"Lua","readme":"# Hammerflow\nA Hammerspoon Spoon to enable a global leader key for your mac that's easy to configure and fun to play with!\n\n## Quick Start\n\n1. Clone the Hammerflow spoon:\n```bash\ngit clone https://github.com/saml-dev/Hammerflow.spoon.git ~/.hammerspoon/Spoons/Hammerflow.spoon\n```\n2. In init.lua load Hammerflow and pass a list of config files for it to search for. It takes absolute paths and paths relative to the Hammerspoon config dir, usually ~/.hammerspoon\n```lua\nhs.loadSpoon(\"Hammerflow\")\nspoon.Hammerflow.loadFirstValidTomlFile({\n    \"home.toml\",\n    \"work.toml\",\n    \"Spoons/Hammerflow.spoon/sample.toml\"\n})\n\n-- optionally register custom functions.\n-- registerFunctions takes 1 or more tables.\n-- each table contains functions that can be \n-- called from your toml config using the\n-- function: prefix, e.g.\n--   h = \"function:hi\"\nlocal fileFuncs = require(\"files.lua\")\nspoon.Hammerflow.registerFunctions(\n    fileFuncs, \n    { [\"hi\"] = function() hs.alert(\"hi\") end }\n)\n\n-- optionally respect auto_reload setting in the toml config.\nif spoon.Hammerflow.auto_reload then\n    hs.loadSpoon(\"ReloadConfiguration\")\n    -- set any paths for auto reload\n    -- spoon.ReloadConfiguration.watch_paths = {hs.configDir, \"/path/to/my/configs/\"}\n    spoon.ReloadConfiguration:start()\nend\n```\n3. (Recommended) Use Karabiner Elements to remap Right Command to f18 for a dedicated leader key.\n4. Explore sample.toml to see what you can do and try out some of the default actions.\n5. Create your own toml config and personalize to your hearts content!\n\n## UI Formatting\n\nCustomize the format of your Hammerflow UI using standard Hammerspoon formatting syntax and separate from.\n\n\u003e [!IMPORTANT]\n\u003e Any formatting must be registered before loading your toml configuration.\n\n```lua\nhs.loadSpoon(\"Hammerflow\")\n-- optionally set ui format (must be done before loading toml config)\n-- 🧛 Dracula inspired theme\nspoon.Hammerflow.registerFormat({\n\tatScreenEdge = 2,\n\tfillColor = { alpha = .875, hex = \"282b36\" },\n\tpadding = 18,\n\tradius = 12,\n\tstrokeColor = { alpha = .875, hex = \"f1fa8b\" },\n\ttextColor = { alpha = 1, hex = \"bd93f9\" },\n\ttextStyle = {\n\t\tparagraphStyle = { lineSpacing = 6 },\n\t\tshadow = { offset = { h = -1, w = 1 }, blurRadius = 10, color = { alpha = .50, white = 0 } }\n\t},\n\tstrokeWidth = 6,\n\ttextFont = \"Monaco\",\n\ttextSize = 18,\n})\nspoon.Hammerflow.loadFirstValidTomlFile({\n\t\"home.toml\",\n\t\"work.toml\",\n\t\"Spoons/Hammerflow.spoon/sample.toml\",\n})\n```\n\n## Full Documentation\nAll available options are demonstrated in [sample.toml](./sample.toml). I will create proper documentation soon.\n\n## Quick start\nSee [Hammerflow.dev](https://hammerflow.dev) for the quick start information.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaml-dev%2Fhammerflow.spoon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaml-dev%2Fhammerflow.spoon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaml-dev%2Fhammerflow.spoon/lists"}