96 lines
2.7 KiB
Markdown
96 lines
2.7 KiB
Markdown
# 🚂 slTrain
|
|
|
|
|
|
|
|
|
|
|
|
A delightful ASCII art train animation for your terminal, bringing joy to command-line enthusiasts everywhere!
|
|
|
|
```
|
|
. . . . . o o o o o
|
|
_____
|
|
__|[_]|__ ___________ _______ ____ o
|
|
|[] [] []| [] [] [] [] [_____(__ ][]]_n_n__][.
|
|
_|________|_[_________]_[________]_|__|________)<
|
|
oo oo 'oo oo ' oo oo 'oo 0000---oo\_
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
```
|
|
|
|
## 🌟 Features
|
|
|
|
- Colorful ASCII art train animation
|
|
- Realistic smoke effect
|
|
- Smooth scrolling across your terminal
|
|
- Customizable train length and smoke patterns
|
|
- Cross-platform compatibility
|
|
|
|
## 🚀 Quick Start
|
|
|
|
```bash
|
|
# Clone the repository
|
|
git clone https://github.com/developtheweb/slTrain.git
|
|
|
|
# Navigate to the project directory
|
|
cd slTrain
|
|
|
|
# Run the train animation
|
|
python sltrain.py
|
|
```
|
|
|
|
## 🛠️ Installation
|
|
|
|
1. Ensure you have Python 3.6+ installed on your system.
|
|
2. Install the required dependencies:
|
|
|
|
```bash
|
|
pip install colorama
|
|
```
|
|
|
|
3. Clone the repository or download the `sltrain.py` file.
|
|
4. Run the script using Python:
|
|
|
|
```bash
|
|
python sltrain.py
|
|
```
|
|
|
|
## 🎨 Customization
|
|
|
|
You can easily customize the train's appearance and behavior by modifying the following variables in `sltrain.py`:
|
|
|
|
- `train_length`: Adjust the length of the train
|
|
- `smoke_length`: Change the length of the smoke trail
|
|
- `start_position`: Set how much of the train is visible at the start
|
|
|
|
Feel free to experiment with colors and ASCII patterns to create your unique train!
|
|
|
|
## 🤝 Contributing
|
|
|
|
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
|
|
|
|
1. Fork the Project
|
|
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
|
|
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
|
|
4. Push to the Branch (`git push origin feature/AmazingFeature`)
|
|
5. Open a Pull Request
|
|
|
|
## 📜 License
|
|
|
|
Distributed under the MIT License. See `LICENSE` for more information.
|
|
|
|
## 🙏 Acknowledgments
|
|
|
|
- Inspired by the classic Unix [`sl` command](https://github.com/mtoyoda/sl)
|
|
- ASCII art community for continuous inspiration
|
|
- All the wonderful contributors and users of this project
|
|
|
|
## 📬 Contact
|
|
|
|
Your Name - [@developtheweb](https://twitter.com/your_twitter)
|
|
|
|
Project Link: [https://github.com/developtheweb/slTrain](https://github.com/developtheweb/slTrain)
|
|
|
|
---
|
|
|
|
<p align="center">
|
|
Made with ❤️ by <a href="https://github.com/developtheweb">developtheweb</a>
|
|
</p>
|