Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sujal-goswami/mythoshell
"Discover 🔱MythoShell: A mythological-themed shell script that transforms common commands into divine interactions for a mystical terminal experience."
https://github.com/sujal-goswami/mythoshell
bash hacktoberfest hacktoberfest-accepted linux shell-script
Last synced: 10 days ago
JSON representation
"Discover 🔱MythoShell: A mythological-themed shell script that transforms common commands into divine interactions for a mystical terminal experience."
- Host: GitHub
- URL: https://github.com/sujal-goswami/mythoshell
- Owner: sujal-goswami
- License: mit
- Created: 2023-07-15T09:10:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-07-18T17:11:03.000Z (over 1 year ago)
- Last Synced: 2024-10-12T17:14:40.118Z (24 days ago)
- Topics: bash, hacktoberfest, hacktoberfest-accepted, linux, shell-script
- Language: Shell
- Homepage:
- Size: 2.74 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🔱MythoShell
> *Unleash the Power of Mythological Scripting*
---------------------------------------
## 🔱MythoShell Installation and Setup Guide
🔱MythoShell is a shell script project that maps common Bash commands to an Indian mythological theme. Follow the instructions below to run and make the project work on your system.
### Prerequisites:
- Make sure you have `Bash` installed on your system. Most Linux distributions come pre-installed with Bash.
- Ensure that your system has internet connectivity to download any necessary dependencies.
### Installing and Running the Project:
1. Clone the 🔱MythoShell repository from GitHub by running the following command:
```
git clone https://github.com/sujal-goswami/MythoShell.git
```
2. Open a terminal and navigate to the directory where you have cloned or downloaded the 🔱MythoShell project.
3. Locate the shell script file that maps the commands to the theme. The file might be named something like `mythoshell.sh`.
4. Before executing the script, ensure that it has executable permissions. If not, run the command `chmod +x mythoshell.sh` to make it executable.
5. To run the MythoShell script, use one of the following commands, depending on the file's permissions:
```
source mythoshell.sh
. mythoshell.sh
```
This will activate the 🔱MythoShell environment and replace the default commands with their Indian mythological language-themed alternatives.
6. Once the script is executed, you can start using the themed commands in your terminal. Try running ls, cd, or any other command in the list below.
### Making 🔱MythoShell Permanent:
To make 🔱MythoShell permanently available whenever you open a new terminal session, follow these steps:
1. Determine the appropriate shell startup file for your system. Common startup file names are `~/.bashrc`, `~/.bash_profile`, or `~/.zshrc`. The startup file is executed every time a new terminal session is opened.
2. Add the command in end to run the MythoShell script. The command should resemble: `source /path/to/mythoshell.sh`. Replace `/path/to/mythoshell.sh` with the actual path to the `mythoshell.sh` file on your system.
3. Close and reopen your terminal, or run the command `source ~/.bashrc` (or the relevant file) to apply the changes immediately.
Now, whenever you open a new terminal session, the 🔱MythoShell environment will be automatically activated, allowing you to enjoy the Indian mythological language-themed commands.
> 📝 **Note :** Ensure that the shell script file `mythoshell.sh` is placed in a location accessible by your system, and modify the startup file's path accordingly.
### Usage and Commands:
Type `margdarshan` to view list.
| Old Command | New Command |
|:--------------------------:|:--------------------------:|
| sudo | devata |
| man | grantha |
| ls | drishti |
| cd | prasthan |
| pwd | sthan |
| mkdir | rachana |
| rm | vinash |
| cp | anupalan |
| mv | sthapana |
| cat | katha |
| grep | spurana |
| chmod | adhikara |
| echo | dhavani |
| date | samayachakra |
| find | khoya |
| history | itihasa |
| whoami | aham |
| touch | sparsha |
| wget | amrit |
| apt-get | amrita-prapti |
| clear | shuddhikaran |
## Contributing
Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request. Let's make 🔱MythoShell even better together!
## License
🔱MythoShell is licensed under the [MIT License](https://github.com/sujal-goswami/MythoShell/blob/main/LICENSE). Feel free to modify, distribute, and use the code for personal or commercial projects.