An open API service indexing awesome lists of open source software.

https://github.com/cyberllloner/sudo-quotes

A fun way to brighten your command-line with quotes from Free Software and GNU/Linux
https://github.com/cyberllloner/sudo-quotes

bash-script free-software funny gnu-linux just-for-fun linux quotes quotes-app random-quotes script shell-script simple-app simple-project

Last synced: 8 months ago
JSON representation

A fun way to brighten your command-line with quotes from Free Software and GNU/Linux

Awesome Lists containing this project

README

          

# 🐧💬 sudo-quotes
> Welcome to **sudo-quotes** a delightful way to enhance your command-line experience with inspiring, humorous, and thought-provoking quotes from the world of Free Software and GNU/Linux.

[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com)
[![forthebadge](https://forthebadge.com/images/badges/license-mit.svg)](https://forthebadge.com)

## 📃 Description
`sudo-quotes` is a lightweight Shell script that injects a dose of inspiration into your command-line routine. Each time you open a new terminal, you'll be greeted with a random quote from the world of Free Software and GNU/Linux, making your terminal sessions more enjoyable and thought-provoking.

## 🛠️ Installation
To install `sudo-quotes`, follow these steps:

1. Clone the repository:
```sh
git clone https://github.com/cyberllloner/sudo-quotes.git
```
2. Navigate to the project directory:
```sh
cd sudo-quotes
```
3. Make the script executable:
```sh
chmod +x sudo-quotes.sh
```
4. To run the script every time a new terminal is opened, add the following line to your shell profile (e.g., `~/.bashrc` or `~/.zshrc`):
```sh
echo "/path/to/sudo-quotes/sudo-quotes.sh" >> ~/.bashrc
```
Replace `/path/to/sudo-quotes/` with the actual path to the `sudo-quotes` directory.
5. Apply the changes to your shell profile:
```sh
source ~/.bashrc
```

## 🚀 Usage
Every time you open a new terminal, a random quote will be displayed.

## 🧩 Contributing
We welcome contributions from the community! Here's how you can contribute:

### Adding Quotes
1. **Fork the repository**: Click the "Fork" button on the top right of the repository page.
2. **Edit `quotes.txt`**: Add your quote in the format `Quote - Source` on a new line.
3. **Commit and create a pull request**.

### Adding Greetings
1. **Fork the repository**: Click the "Fork" button on the top right of the repository page.
2. **Edit `greetings.txt`**: Add your greeting on a new line.
3. **Commit and create a pull request**.

#### Important: Please add each quote and source/greeting on a single line, even if it's too long.

### Contributing to Code
1. Fork the repository by clicking the "Fork" button on the top right of the repository page.
2. Clone your forked repository:
```sh
git clone https://github.com/your-username/sudo-quotes.git
cd sudo-quotes
```
3. Create a new branch:
```sh
git checkout -b feature/your-feature
```
4. Make your changes and commit them:
```sh
git commit -am "Add: your feature"
```
5. Push to the branch:
```sh
git push origin feature/your-feature
```
6. Open a pull request by navigating to your forked repository on GitHub and clicking the "New pull request" button.

## 📜 License
[MIT License](LICENSE)