{"id":17988534,"url":"https://github.com/heyvito/oxio","last_synced_at":"2025-03-25T22:33:51.284Z","repository":{"id":57651226,"uuid":"328281411","full_name":"heyvito/oxio","owner":"heyvito","description":"🦀 A nimble snippet manager","archived":false,"fork":false,"pushed_at":"2021-03-11T01:55:16.000Z","size":32,"stargazers_count":17,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-20T22:03:54.272Z","etag":null,"topics":["cli","clipboard","rust","snippets","snippets-manager"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/heyvito.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}},"created_at":"2021-01-10T01:37:23.000Z","updated_at":"2025-03-18T03:21:52.000Z","dependencies_parsed_at":"2022-09-05T02:51:08.515Z","dependency_job_id":null,"html_url":"https://github.com/heyvito/oxio","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyvito%2Foxio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyvito%2Foxio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyvito%2Foxio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyvito%2Foxio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heyvito","download_url":"https://codeload.github.com/heyvito/oxio/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245556284,"owners_count":20634876,"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":["cli","clipboard","rust","snippets","snippets-manager"],"created_at":"2024-10-29T19:11:56.954Z","updated_at":"2025-03-25T22:33:50.987Z","avatar_url":"https://github.com/heyvito.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Oxio\n[![crates.io](https://img.shields.io/crates/v/oxio.svg)](https://crates.io/crates/oxio)\n\nOxio is a small snippet manager inspired by [Zach Holman](https://github.com/holman/)'s [boom](https://github.com/holman/boom). Quoting Zach's description of boom:\n\n\u003e You can stash away text like URLs, canned responses, and important notes and then quickly copy them onto your clipboard, ready for pasting.\n\n\u003ccenter\u003e\u003cimg src=\"https://user-images.githubusercontent.com/77198/104183876-631cfd00-53f1-11eb-81a3-df01d302074c.png\" /\u003e\u003c/center\u003e\n\n## Installing\n\nInstall using [`cargo`](https://crates.io/):\n\n\n\n```\ncargo install oxio\n```\n\n## Usage\n\n```\n ▲ oxio gif magic http://i.imgur.com/n5xR79B.gif\noxio: Ok, magic (in gif) is http://i.imgur.com/n5xR79B.gif\n\n ▲ oxio magic\noxio: http://i.imgur.com/n5xR79B.gif (from gif-\u003emagic) is now in your clipboard!\n\n ▲ oxio rm-item gif magic\noxio: Removed magic from gif\n```\n\n### Manipulating Items\n\nTo add items to your local cache, invoke `oxio` passing three arguments;\nA `group`, the item `name` and the item's `value`. Those arguments are used\nto write a new file in the local cache:\n\n```\n▲ oxio gif magic http://i.imgur.com/n5xR79B.gif\n  ------^----^-----------------^----------------\n        |    |                 |\n        |    |                 Value\n        |    Name\n        Group\n```\n\nTo quickly copy an item to the clipboard, simply invoke `oxio` passing the\nitem name in the first argument:\n\n```\n▲ oxio magoc\noxio: http://i.imgur.com/n5xR79B.gif (from gif-\u003emagic) is now in your clipboard!\n```\n\nIt then copies the item to your clipboard. Notice that the command above asked\nfor `magoc` instead of `magic`. Oxio attempts automatically fix typos.\nIn case you need an exact item, from an exact group, invoke `oxio` passing\nthe group, followed by the item's name:\n\n```\n▲ oxio gif magic\noxio: http://i.imgur.com/n5xR79B.gif (from gif-\u003emagic) is now in your clipboard!\n```\n\nTo remove an item, use `rm-item`, again, passing the group's and item's name:\n\n```\n▲ oxio rm-item gif magic\noxio: Removed magic from gif\n```\n\nTo remove a group and all its items, use `rm-group`:\n\n```\n▲ oxio rm-group gif magic\noxio: Removed group gif and all its items.\n```\n\nThen, to display all your items, use `oxio all`:\n\n```\n▲ oxio all\ngif:\n  magic: http://i.imgur.com/n5xR79B.gif\n```\n\nAlternatively, to edit large items using your default editor, use `oxio edit`,\npassing the group's and item's name:\n\n```\n▲ oxio edit gif magic\n[opens your editor]\noxio: Ok, magic (in gif) is foobar\n```\n\n### Sync\n\nFor those using multiple machines, Oxio is able to sync a repository\nwith all local items.\nTo start using sync, create a new remote repository, and use one of the\nfollowing alternatives:\n\n#### With an existing cache\nIn case you already have a local cache (you already added items),\nuse `oxio sync merge git-url`, where `git-url` is a git repository:\n\n```\n▲ oxio sync merge git@github.com:yourusername/.oxio.git\noxio: Clonning git@github.com:yourusername/.oxio.git into /var/folders/l1/n7yv6s4d5350p7nxyn8bmtsc0000gn/T/zcl7bKG1cY0mvMcpG5Y9AGjpnICvVa\noxio: Copying items to new temporary repository...\noxio: Performing sync...\noxio: Merging changes...\noxio: Pushing changes...\noxio: Sync complete\noxio: Applying local changes...\noxio: Done! 220 item(s) in the local repository. Use oxio sync to sync changes.\n```\n\nOxio will automatically update the repository and your installation.\n\n#### Without an existing cache\nIn case you haven't added items into your local cache, or you already have\na repository with Oxio items and want to download to your machine, use\n`oxio sync init git-url`:\n\n```\n▲ oxio sync init git@github.com:yourusername/.oxio.git\noxio: Clonning git@github.com:yourusername/.oxio.git into /Users/yourusername/.oxio.cache\noxio: Done! 219 item(s) in the local repository. Use oxio sync to sync changes.\n```\n\n#### Syncing changes to your local cache\nAfter adding, removing or editing items or groups, simply invoke `oxio sync`.\nRemote changes will be downloaded to the local repository, and local changes\nwill be sent to it.\n\n```\n▲ oxio sync\noxio: Performing sync...\noxio: Merging changes...\noxio: Pushing changes...\noxio: Sync complete\n```\n\n## TODO\n\n- [ ] Add Tests\n\n## License\n\n```\nMIT License\n\nCopyright (c) 2021 Victor Gama\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyvito%2Foxio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheyvito%2Foxio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyvito%2Foxio/lists"}