{"id":29082006,"url":"https://github.com/denism8977/hammerspoon","last_synced_at":"2025-07-10T12:06:44.014Z","repository":{"id":301496934,"uuid":"1009356542","full_name":"denism8977/Hammerspoon","owner":"denism8977","description":"Hammerspoon is a powerful macOS automation tool that uses Lua scripts for window management, hotkeys, and system control. Unlock your productivity! 🛠️🌟","archived":false,"fork":false,"pushed_at":"2025-06-27T06:03:04.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-27T07:20:38.572Z","etag":null,"topics":["automation","dotfiles","hacktoberfest","hammerspoon","hammerspoon-configuration","hyper-shortcuts","irc","literate-configuration","lua","objective-c","osx","sierra","spoons","stacks","tabbed-layout","toggl","vim","vim-bindings"],"latest_commit_sha":null,"homepage":"https://denism8977.github.io","language":null,"has_issues":false,"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/denism8977.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,"zenodo":null}},"created_at":"2025-06-27T02:09:32.000Z","updated_at":"2025-06-27T06:03:07.000Z","dependencies_parsed_at":"2025-06-27T07:20:40.637Z","dependency_job_id":"fdc1342c-fb91-4e64-8077-8c82ddd03465","html_url":"https://github.com/denism8977/Hammerspoon","commit_stats":null,"previous_names":["denism8977/hammerspoon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/denism8977/Hammerspoon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denism8977%2FHammerspoon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denism8977%2FHammerspoon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denism8977%2FHammerspoon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denism8977%2FHammerspoon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/denism8977","download_url":"https://codeload.github.com/denism8977/Hammerspoon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/denism8977%2FHammerspoon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262324906,"owners_count":23293749,"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":["automation","dotfiles","hacktoberfest","hammerspoon","hammerspoon-configuration","hyper-shortcuts","irc","literate-configuration","lua","objective-c","osx","sierra","spoons","stacks","tabbed-layout","toggl","vim","vim-bindings"],"created_at":"2025-06-27T20:01:42.784Z","updated_at":"2025-06-27T20:03:08.984Z","avatar_url":"https://github.com/denism8977.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hammerspoon: Powerful macOS Automation Tool with Lua Scripting\n\n![Hammerspoon Logo](https://hammerspoon.org/images/hammerspoon-logo.png)\n\n![GitHub release](https://img.shields.io/github/release/denism8977/Hammerspoon.svg) [![Download Latest Release](https://img.shields.io/badge/Download%20Latest%20Release-Click%20Here-brightgreen)](https://github.com/denism8977/Hammerspoon/releases)\n\n## 🛠️ What Is Hammerspoon?\n\nHammerspoon is a robust automation tool for macOS that connects system-level APIs with a Lua scripting engine. With Hammerspoon, you can write Lua scripts to control various aspects of your system, including windows, applications, audio devices, clipboard, hotkeys, mouse events, and much more. For detailed information, visit [hammerspoon.org](https://hammerspoon.org).\n\n## ⚙️ Core Features\n\n### System API Access\n\nHammerspoon provides access to a wide range of system APIs. You can use Lua scripts to manipulate:\n\n- Windows\n- Applications\n- Filesystem\n- Audio\n- Screens\n- Keyboard and mouse events\n- Network\n\nThis extensive access allows you to create custom solutions tailored to your workflow.\n\n### Extensible Through “Spoons”\n\nSpoons are modular plugins that enhance Hammerspoon's functionality. You can use Spoons to:\n\n- Launch applications\n- Manage screen brightness\n- Keep a clipboard history\n- Implement Pomodoro timers\n- Display clocks\n\nThis modularity allows you to add features as needed without cluttering your main configuration.\n\n### Configurable Hotkeys\n\nWith Hammerspoon, you can bind any key combination to trigger scripts or actions. This feature enables you to streamline your workflow and execute commands quickly.\n\n### Window Management\n\nEfficient window management is crucial for productivity. Hammerspoon allows you to:\n\n- Move and resize windows\n- Tile windows for better organization\n\nThese features are ideal for users who work with multiple applications simultaneously.\n\n### Accessibility and Automation\n\nHammerspoon can automate repetitive tasks, making your workflow smoother. You can create scripts that interact with various applications and system functions seamlessly.\n\n## 🚀 Getting Started\n\n### Installation\n\n1. Download the latest release from the [Releases section](https://github.com/denism8977/Hammerspoon/releases). Follow the instructions to install and execute the application.\n\n2. Open Hammerspoon, and you will see its icon in the menu bar.\n\n3. Create your `init.lua` configuration file in the `~/.hammerspoon/` directory. This file is where you will write your Lua scripts.\n\n### Example Script\n\nHere’s a simple example of a Lua script to get you started:\n\n```lua\nhs.hotkey.bind({\"cmd\", \"alt\"}, \"H\", function()\n    hs.alert.show(\"Hello, Hammerspoon!\")\nend)\n```\n\nThis script binds the key combination `Command + Option + H` to display a simple alert.\n\n## 📚 Documentation\n\nHammerspoon has comprehensive documentation available on its [official website](https://hammerspoon.org). The documentation covers:\n\n- API references\n- Tutorials\n- Examples\n\nRefer to the documentation to learn more about scripting and advanced features.\n\n## 🧩 Spoons\n\nSpoons are an essential part of Hammerspoon. To install a Spoon:\n\n1. Find the Spoon you want to use from the [Spoon repository](https://github.com/Hammerspoon/Spoons).\n2. Clone or download the Spoon.\n3. Place it in the `~/.hammerspoon/Spoons/` directory.\n4. Load the Spoon in your `init.lua` file:\n\n```lua\nhs.loadSpoon(\"SpoonName\")\n```\n\nReplace `SpoonName` with the actual name of the Spoon you want to load.\n\n## 🌐 Community and Support\n\nHammerspoon has an active community where you can seek help and share your scripts. You can join the discussions on:\n\n- [Hammerspoon Google Group](https://groups.google.com/forum/#!forum/hammerspoon)\n- [Hammerspoon Discord](https://discord.gg/hammerspoon)\n\nFeel free to ask questions or share your experiences with other users.\n\n## 🔧 Troubleshooting\n\nIf you encounter issues, check the following:\n\n- Ensure your Lua syntax is correct.\n- Look for error messages in the Hammerspoon console.\n- Consult the [documentation](https://hammerspoon.org) for guidance.\n\n## 🗂️ Repository Topics\n\nThis repository includes various topics related to Hammerspoon, such as:\n\n- audio-control\n- automation\n- battery-status\n- custom-ui\n- hammerspoon\n- macos\n- macos-tools\n- mouse-events\n- multimonitor\n- plugin-system\n- spoons\n- wifi-monitoring\n- window-management\n- workflow-automation\n\nThese topics reflect the versatility and power of Hammerspoon in automating tasks on macOS.\n\n## 🎉 Contributing\n\nContributions are welcome! If you want to help improve Hammerspoon:\n\n1. Fork the repository.\n2. Create a new branch for your feature or fix.\n3. Submit a pull request with a clear description of your changes.\n\nYour contributions can help enhance the Hammerspoon experience for all users.\n\n## 🔗 Additional Resources\n\n- [Hammerspoon Documentation](https://hammerspoon.org)\n- [Hammerspoon GitHub Repository](https://github.com/Hammerspoon/hammerspoon)\n- [Lua Programming Language](https://www.lua.org)\n\nFor the latest updates, check the [Releases section](https://github.com/denism8977/Hammerspoon/releases) regularly. \n\n## 📖 Examples and Use Cases\n\nHammerspoon can be used in various scenarios. Here are some practical examples:\n\n### Automating Window Layouts\n\nYou can create scripts to automatically arrange your windows based on your workflow. For example, if you often work with a code editor and a web browser, you can set up a script to position these windows side by side.\n\n### Managing System Volume\n\nControl your system's audio settings with a simple script. You can create hotkeys to increase or decrease volume or mute the audio entirely.\n\n### Clipboard Management\n\nImplement a clipboard history feature to access previously copied items. This can be helpful for users who frequently copy and paste.\n\n### Pomodoro Timer\n\nUse Hammerspoon to create a Pomodoro timer that alerts you when to take breaks. This can enhance productivity and focus.\n\n## 🖥️ User Interface Customization\n\nHammerspoon allows for custom UI elements. You can create pop-up windows, notifications, and alerts that fit your workflow. This feature can help you design a personalized automation experience.\n\n## 📊 Performance Monitoring\n\nYou can monitor system performance metrics using Hammerspoon. Create scripts to track CPU usage, memory consumption, or network activity. This information can help you optimize your system's performance.\n\n## 📅 Scheduling Tasks\n\nSchedule tasks to run at specific times. You can use Hammerspoon to automate daily routines, such as opening specific applications or performing backups.\n\n## 📲 Mobile Device Integration\n\nIntegrate Hammerspoon with mobile devices for seamless communication. For example, you can set up notifications to appear on your desktop when you receive messages on your phone.\n\n## 🔄 Synchronizing Settings\n\nSynchronize your Hammerspoon settings across multiple devices using cloud storage solutions like Dropbox or Google Drive. This way, you can maintain a consistent setup regardless of the device you use.\n\n## 🏷️ Tags and Labels\n\nUtilize tags and labels in your scripts to organize your automation tasks. This can help you quickly identify and manage different scripts based on their functionality.\n\n## 📜 Best Practices\n\n- Keep your `init.lua` file organized.\n- Comment your code for clarity.\n- Regularly back up your scripts.\n- Test scripts thoroughly before deploying them.\n\nBy following these best practices, you can maintain a clean and efficient automation setup.\n\n## 🎨 Visual Customization\n\nHammerspoon allows for visual customization of your alerts and notifications. You can choose colors, fonts, and styles that match your personal preferences.\n\n## 🔗 Integrating with Other Tools\n\nHammerspoon can work alongside other tools and applications. For example, you can integrate it with task management apps or project management tools to streamline your workflow.\n\n## 📊 Data Visualization\n\nUse Hammerspoon to create data visualizations. You can display system metrics or performance data in a visually appealing format, making it easier to understand and analyze.\n\n## 🌍 Internationalization\n\nHammerspoon supports multiple languages. You can create scripts that adapt to different languages and locales, making it a versatile tool for users around the world.\n\n## 🎤 Voice Commands\n\nIntegrate voice commands into your Hammerspoon setup. Use voice recognition to trigger scripts and automate tasks hands-free.\n\n## 🎮 Game Integration\n\nFor gamers, Hammerspoon can enhance the gaming experience. Create scripts that automate in-game actions or manage system resources while gaming.\n\n## 📚 Learning Resources\n\nTo further your understanding of Hammerspoon and Lua, consider exploring:\n\n- Online courses on Lua programming.\n- Tutorials on automation techniques.\n- Community forums for tips and tricks.\n\n## 🔄 Keeping Up with Updates\n\nStay informed about updates and new features by following the official Hammerspoon channels. Regularly check the [Releases section](https://github.com/denism8977/Hammerspoon/releases) for the latest changes and improvements.\n\n## 🛠️ Troubleshooting Common Issues\n\nIf you face issues, consider the following steps:\n\n1. Check for syntax errors in your Lua scripts.\n2. Ensure all required Spoons are installed and loaded.\n3. Consult the community for advice and solutions.\n\nBy addressing common problems, you can ensure a smooth experience with Hammerspoon.\n\n## 📝 User Feedback\n\nUser feedback is valuable for improving Hammerspoon. If you have suggestions or feature requests, feel free to reach out through the community channels.\n\n## 📈 Future Development\n\nThe future of Hammerspoon looks promising. Developers are continually working on new features and improvements. Stay engaged with the community to keep up with the latest developments.\n\n## 🌟 Conclusion\n\nHammerspoon is a powerful tool for macOS users looking to automate tasks and enhance their workflow. With its Lua scripting capabilities and extensive features, it offers a flexible solution for various automation needs. Explore the possibilities and make your macOS experience more efficient.\n\nFor more information and to download the latest version, visit the [Releases section](https://github.com/denism8977/Hammerspoon/releases).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdenism8977%2Fhammerspoon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdenism8977%2Fhammerspoon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdenism8977%2Fhammerspoon/lists"}