{"id":30763502,"url":"https://github.com/brian10101/qwer","last_synced_at":"2026-04-13T12:01:49.883Z","repository":{"id":308250390,"uuid":"1031993565","full_name":"brian10101/qwer","owner":"brian10101","description":"A simple Linux terminal tool meant to allow users to navigate the terminal more efficiently and get more out of executing a single command.","archived":false,"fork":false,"pushed_at":"2025-08-13T01:05:09.000Z","size":33,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-04T16:07:02.958Z","etag":null,"topics":["bash","bash-script","linux","linux-shell","linux-terminal","linux-terminal-tools","shell-script","shell-scripts"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/brian10101.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-08-04T16:31:41.000Z","updated_at":"2025-08-13T04:06:27.000Z","dependencies_parsed_at":"2025-08-05T00:42:24.661Z","dependency_job_id":"f1d75530-412c-4991-a13b-3624bcbc6afc","html_url":"https://github.com/brian10101/qwer","commit_stats":null,"previous_names":["brian10101/qwer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/brian10101/qwer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brian10101%2Fqwer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brian10101%2Fqwer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brian10101%2Fqwer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brian10101%2Fqwer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brian10101","download_url":"https://codeload.github.com/brian10101/qwer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brian10101%2Fqwer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31751705,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T09:16:15.125Z","status":"ssl_error","status_checked_at":"2026-04-13T09:16:05.023Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bash","bash-script","linux","linux-shell","linux-terminal","linux-terminal-tools","shell-script","shell-scripts"],"created_at":"2025-09-04T16:04:17.945Z","updated_at":"2026-04-13T12:01:49.835Z","avatar_url":"https://github.com/brian10101.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003eqwer\u003c/h1\u003e\n\n\u003ch2\u003eAbout\u003c/h2\u003e\n\n\u003ch3\u003eWhat is it?\u003c/h3\u003e\n\n\u003cp\u003e qwer is a simple Linux terminal tool used to clear the terminal, return 'ls', current time, working directory path, machine name, and current user all at once in a user firendly view. It is meant to allow to allow users to navigate and clear their terminal more efficiently. Additionally, qwer comes with robust built-in install and uninstall scripts along with a configuration file. Any changes made to this config file are immediately reflected in the qwer command installed in /usr/local/bin and will be visible the next time you run qwer.\u003c/p\u003e\n\n\u003ch3\u003eWhy I made it?\u003c/h3\u003e\n\n\u003cp\u003eWhile learning to navigate the terminal, I often found myself chaining the clear and ls commands. That’s when I decided to create a tool that combined the two! I named it qwer because those letters are right next to each other on the keyboard, and all the fingers are close by while typing. This allows the user to execute the tool quickly. Over time, I added features and improvements, leading to the current version of qwer.\u003c/p\u003e\n\n\u003ch2\u003eInstallation\u003c/h2\u003e\n\n\u003cp\u003eSince some parts of the installation need root privileges, I will use sudo su to switch to root. However, you are free to use sudo instead for commands that require privileges, such as running install.sh or uninstall.sh.\u003c/p\u003e\n\n    git clone https://github.com/brian10101/qwer.git\n    cd qwer\n    sudo su\n\nThen run\n\n    bash install.sh\n\n\u003ch4\u003eOutput:\u003c/h4\u003e\n\n```\n┌──(root@workstation1)-[/home/brian/qwer]\n└─# bash install.sh\n\n *########*                      ,*.              ,*.  ,*.   \n    '##'                       __|#|__            |#|  |#|   \n     ##      *        ,####*. *#######*   __   *  |#|  |#|   \n     ##      #.\u0026#\u0026,  \u0026         '‾|#|‾'  #'  '#.#  |#|  |#|   \n     ##      #    #   '*###,     |#|   #'    '|#  |#|  |#|   \n    ,##,     #    #        \u0026     |#|   \u0026      |#  |#|  |#|   \n *########*  *    *  '*###*'     '*'   '\u0026.__#/'*  '*'  '*'   \n                                                             \n                                                             \n- Installing now\n- qwer.conf was successfully sourced in qwer.sh\n- Location of qwer dir has been saved to qwer.conf\n- qwer has now been installed!\n- It can now be used by anyone, anywhere, just by typing 'qwer'.\n- For more info, run 'qwer --help'.\n```\n\nNow that you have completed the installation, qwer could be used by anyone (No sudo or root needed), anywhere, just by typing `qwer`!\n\n\u003ch2\u003eUsing qwer\u003c/h2\u003e\n\n```\nqwer\n```\n\n\u003ch4\u003eExample output:\u003c/h4\u003e\n\n```\n┌──((brian@workstation1)(7:26 PM))-[/home/brian/Documents/writing]\n└─ls\nideas        old_writing      writing1.txt        writing2.txt\nnew_writing  short_story.txt  writing2_final.txt\n```\n\n\u003ch3\u003e--help:\u003c/h3\u003e\n\n    qwer --help\n\n\u003ch4\u003eOutput:\u003c/h4\u003e\n\n```\n┌──((brian@workstation1)(7:26 PM))-[/home/brian/Documents/writing]\n└─$ qwer --help\nqwer - A terminal tool used to clear the terminal, return 'ls', current time, working directory path, machine name, and current user all at once in a user friendly view.\n\nqwer comes with robust built-in install and uninstall scripts along with a configuration file.\n\nAny changes made to the config file will be reflected in the qwer installed in /usr/local/bin. Meaning, you can make a change and immediately run qwer!\n\nAll qwer scripts and configs are found in the 'qwer' directory.\n\nHow to run: just enter 'qwer'\n\nReference (qwer output structure):\n┌──(([machine_name]@[current user])([time AM/PM format]))-[[current dir path]]\n└─ls\n[Directories and files in current directory]\n\nOptions:\n  --help - Show this message\n  --version - Show version number\n\nUsing uninstall.sh, install.sh, or qwer.conf:\n\nNavigate to the 'qwer' directory\nIF the 'qwer' directory's location has not changed since the last time bash install.sh was ran AND qwer.conf was successfully sourced in qwer.sh\n\nThen this is the qwer directory:\n/home/brian/qwer\n\nUsing uninstall.sh, install.sh, or qwer.conf:\n\nIf it ends in .sh, run: 'bash [file].sh'\nIf it ends in .conf, run: nano [file].conf\n\nCreated by: Brian Calle (https://github.com/brian10101/)\n\n```\n\n\u003ch2\u003eSetting configurations\u003c/h2\u003e\n\u003cp\u003eNavigate to the 'qwer' directory. This is the directory that was created when you downloaded qwer. It is important because it contains all the control files for qwer, including install.sh, uninstall.sh, and qwer.conf\u003c/p\u003e\n\u003cp\u003eOR: run if you dont know where it is located, run qwer --help and you will see the last known path for the qwer directory\u003c/p\u003e\n\u003cp\u003eWhen you are in the 'qwer' directory run:\u003c/p\u003e\n\n    nano qwer.conf\n\n\u003cp\u003eThis allows you to open and use the Nano text editor. I recommend using Nano, as it's available in many Linux distributions, but you can use any text editor you prefer.\u003c/p\u003e\n\n\u003cp\u003eUse the arrow keys to move the cursor and edit the configuration file according to the instructions provided within it. These instructions will guide you on what can and cannot be customized.\u003c/p\u003e\n\n\u003cp\u003eWhen you're done editing, press \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eO\u003c/kbd\u003e to save, then \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eX\u003c/kbd\u003e to exit. The next time you run qwer, your new configurations will be applied.\u003c/p\u003e\n\n\n\u003ch2\u003eUninstalling\u003c/h2\u003e\n\u003cp\u003eNavigate to the 'qwer' directory and run:\u003c/p\u003e\n\n    sudo bash uninstall.sh\n\n\u003ch4\u003eOutput:\u003c/h4\u003e\n\n```\n┌──(brian@workstation1)-[~/qwer]\n└─$ sudo bash uninstall.sh\n[sudo] password for kali:\n \n ,*       *,         _                    ,*.             ,*. ,*. \n |#       #|        |#|                 __|#|__           |#| |#| \n |#       #| *       ‾  *       ,####*.*#######*  __   *  |#| |#| \n |#       #| #.\u0026#\u0026, ,*. #.\u0026#\u0026, \u0026        '‾|#|‾' #'  '#.#  |#| |#| \n .#       #, #    # |#| #    #  '*###,    |#|  #'    '|#  |#| |#| \n  .#,   ,#,  #    # |#| #    #       \u0026    |#|  \u0026      |#  |#| |#| \n   '*###*'   *    * '*' *    * '*###*'    '*'  '\u0026.__#/'*  '*' '*' \n                                                                           \n                                                                           \nWhat type of Uninstall do you want?\n\nOptions:\n1. Partial: Removes qwer from '/usr/local/bin/'.\nUse case: To replace the working version of qwer. Example: If you make changes to bash.sh and want to update your working qwer, run this before using install to set your new version.\n\n2. Total: Removes qwer from '/usr/local/bin/' and removes qwer directory\nUse case: To completely delete everything about qwer. Use before downloading new update from repo: https://github.com/brian10101/qwer or Uninstall Completely\n\n3. Exit: Leave this script\n\nInput option number (1, 2, or 3):\n\n```\n\n\u003cp\u003eChoose the option that best fits your use case.\u003c/p\u003e\n\u003cp\u003eEach option is very user-friendly, self-explanatory, and has tons of error handling, so I won't be walking you through each of them.\u003c/p\u003e\n\n\u003ch3\u003eImportant, Keep in mind:\u003c/h3\u003e\n\n\u003cp\u003eAfter you run the 'Total' option in the uninstall.sh script you will get the follwing warning. However it is nothing to worry about. As long as you follow its instructions you will be ok!\u003c/p\u003e\n\n\u003ch4\u003eThe Warning you will get:\u003c/h4\u003e\n\n```\nInput option number (1, 2, or 3):\n\n2\n\n- Are you sure you want to delete ALL of qwer including the install and uninstall scripts? (enter 'y' or 'n')\ny\n- 'qwer' directory removed.\n- qwer has been removed from '/usr/local/bin/'\n\n- If you decide to use qwer again please go to https://github.com/brian10101/qwer\n\n*.                  .*                                  \n \\#,               /#'                         _                   \n  \\#,             /#'                         |#|                     \n   \\#,           /#'   __   *  * ,#*  *        ‾   *          __   *  \n    \\#,   /#    /#'  #'  '#.#  ##'    #.\u0026#\u0026,  ,*.  #.\u0026#\u0026,   #'  '#.#  \n     \\#, /# #  /#'  #'    '|#  #      #    #  |#|  #    #  #'     |#  \n      \\#/#   #/#'   \u0026      |#  #      #    #  |#|  #    #  \u0026      ##  \n       '*     *'    '\u0026.__#/'*  *      *    *  '*'  *    *  '\u0026.__#/|#  \n                                                                  .#  \n                                                                  ,#  \n                                                                 ,#'  \n                                                           *\\#\u0026//*'  \nWARNING: You are currently in a DELETED directory! \nPlease RUN 'cd ..'\n\nThis happened becuase the uninstall.sh script deleted the 'qwer' directory(which was this one.)\nNo need to panic, just RUN 'cd ..' to return to a valid location\n\n- Thank you for trying qwer!\n\n                              \n```\n\u003cp\u003eTo sum up what to do when you get this warning, just run 'cd ..'.\u003c/p\u003e\n\n\u003ch3\u003eNOTE:\u003c/h3\u003e\n\u003cp\u003eAs you may have noticed, this project includes some ASCII art. If you decide to make some changes to changes to the qwer project using an IDE such as VS Code, some of the art, especially in qwer.conf, may appear distorted.\u003c/p\u003e\n\u003cp\u003eIf this happens, don’t worry. The art is still intact and will display correctly when you run the file in a terminal or in nano.\u003c/p\u003e\n\u003cp\u003eLastly, this is just a warning and is not meant to discourage you from making your own additions or changes to qwer.\u003c/p\u003e\n\n\u003ch2\u003eEnd\u003c/h2\u003e\n\n\u003cp\u003eThat is all!\u003c/p\u003e\n\u003cp\u003eThanks for checking out this repo.\u003c/P\u003e\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrian10101%2Fqwer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrian10101%2Fqwer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrian10101%2Fqwer/lists"}