{"id":16373913,"url":"https://github.com/minidigger/thelounge-plugin-shortcuts","last_synced_at":"2025-07-07T14:10:27.445Z","repository":{"id":35002479,"uuid":"195002372","full_name":"MiniDigger/thelounge-plugin-shortcuts","owner":"MiniDigger","description":"Simple plugin for the irc client thelounge that allows you to register shortcuts/aliases for commands","archived":false,"fork":false,"pushed_at":"2025-05-19T20:30:11.000Z","size":184,"stargazers_count":15,"open_issues_count":18,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-20T23:43:24.704Z","etag":null,"topics":["hacktoberfest","thelounge","thelounge-plugin"],"latest_commit_sha":null,"homepage":"https://minidigger.github.io/thelounge-plugin-shortcuts/","language":"JavaScript","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/MiniDigger.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2019-07-03T07:29:46.000Z","updated_at":"2025-04-09T10:14:25.000Z","dependencies_parsed_at":"2023-01-15T11:49:29.935Z","dependency_job_id":"9d5a7a78-ba88-44fb-bbab-c08102836859","html_url":"https://github.com/MiniDigger/thelounge-plugin-shortcuts","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/MiniDigger/thelounge-plugin-shortcuts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniDigger%2Fthelounge-plugin-shortcuts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniDigger%2Fthelounge-plugin-shortcuts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniDigger%2Fthelounge-plugin-shortcuts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniDigger%2Fthelounge-plugin-shortcuts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MiniDigger","download_url":"https://codeload.github.com/MiniDigger/thelounge-plugin-shortcuts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiniDigger%2Fthelounge-plugin-shortcuts/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264089672,"owners_count":23555785,"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":["hacktoberfest","thelounge","thelounge-plugin"],"created_at":"2024-10-11T03:15:35.404Z","updated_at":"2025-07-07T14:10:27.425Z","avatar_url":"https://github.com/MiniDigger.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# thelounge-plugin-shortcuts [![build status](https://github.com/MiniDigger/thelounge-plugin-shortcuts/workflows/Build/badge.svg)](https://github.com/MiniDigger/thelounge-plugin-shortcuts/workflows/build) [![npm downloads](https://img.shields.io/npm/dt/thelounge-plugin-shortcuts.svg)](https://www.npmjs.com/package/thelounge-plugin-shortcuts) [![npm versions](https://img.shields.io/npm/v/thelounge-plugin-shortcuts.svg)](https://www.npmjs.com/package/thelounge-plugin-shortcuts) [![licence mit](https://img.shields.io/github/license/MiniDigger/thelounge-plugin-shortcuts.svg)](https://github.com/MiniDigger/thelounge-plugin-shortcuts/blob/master/LICENSE)\n\nSimple plugin for the irc client [thelounge](https://thelounge.chat) that allows you to register shortcuts/aliases for commands\n\n# Installation\n\n- If you have installed thelounge via NPM/Yarn:\n\n  `thelounge install thelounge-plugin-shortcuts`\n\n- If you have installed thelounge via source:\n\n  `node index.js install thelounge-plugin-shortcuts`\n\n# Usage\n\nAdding a shortcut: `/shortcut add \u003cfrom\u003e \u003cto\u003e`, for example `/shortcut add j /join`.\n\n**Note: you do need to add a `/` to the target, not doing so will just write `join` in the chat window**\n\nRemoving a shortcut: `/shortcut remove \u003cname\u003e`, for example `/shortcut remove j`.\n\nYou may choose to have one shortcut run multiple commands. To do so, just add a second shortcut via `/shortcut addnext \u003cfrom\u003e \u003cto\u003e`.\n\nListing all shortcuts: `/shortcut list`.\n\nShortcuts are saved to `THELOUNGE_HOME/packages/shortcuts.json`\n\n# Placeholders\n\n`thelounge-plugin-shortcuts` supports multiple placeholders:\n\n- `{currentChannel}` will be replaced with the name of the channel where the shortcut was executed in\n- `{0}`, `{1}`, `{n}` will be replaced with the first, second or nth argument that was entered after the shortcut\n- `{args}` will be replaced with all arguments which were entered after the shortcut\n\n# Examples\n\n`/shortcut add shrug ¯\\_(ツ)_/¯` -\u003e /shrug will send ¯\\_(ツ)\\_/¯  \n`/shortcut add j /join {args}` -\u003e /j is an alias to /join  \n`/shortcut add jc /join #my-cool-channel` -\u003e /jc will join a bunch of channels  \n`/shortcut add akick /msg chanserv akick {currentChannel} add {0} !T {1}` -\u003e will akick SomeUser for 20 minutes\n\n# Development\n\nCurrently thelounge doesn't offer a way to install packages from source without npm,\nthats why you have to do it manually.\n\nThe easiest way is installing thelounge locally and adding this plugin as a new package in the THELOUNGE_HOME/packages dir.\nFor that you need to have a package.json in that packages dir that looks kinda like this:\n\n```json\n{\n  \"private\": true,\n  \"description\": \"Packages for The Lounge. All packages in node_modules directory will be automatically loaded.\",\n  \"dependencies\": {\n    \"thelounge-theme-mininapse\": \"2.0.15\",\n    \"thelounge-plugin-shortcuts\": \"1.0.1\",\n    \"thelounge-plugin-giphy\": \"1.0.1\"\n  }\n}\n```\n\nthe important thing in the name here.\n\nYou then need to create a folder with that name in the node_modules sub dir.\nWe then need to place our index.js and package.json in that dir.\nYou can either do that manually by just copy pasting it, but that would involve copy pasting it for every change.\nI would recommend symlinking the files from the project into the packages folder, kinda like this:\n\n```\nln package.json ../thelounge-home/packages/node_modules/thelounge-plugin-shortcuts/package.json\nln index.js ../thelounge-home/packages/node_modules/thelounge-plugin-shortcuts/index.js\n```\n\nYou can then just edit and commit the files in the project dir and restart thelounge\non every change you do and the changes will be picked up.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminidigger%2Fthelounge-plugin-shortcuts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminidigger%2Fthelounge-plugin-shortcuts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminidigger%2Fthelounge-plugin-shortcuts/lists"}