https://github.com/mdgrs-mei/FancyClearHost

Clears your PowerShell host in a fancy way.
https://github.com/mdgrs-mei/FancyClearHost

Last synced: 7 days ago
JSON representation

Clears your PowerShell host in a fancy way.

• Host: GitHub
• URL: https://github.com/mdgrs-mei/FancyClearHost
• Owner: mdgrs-mei
• License: mit
• Created: 2022-10-11T13:32:31.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2022-10-21T05:40:56.000Z (about 2 years ago)
• Last Synced: 2024-08-02T17:34:21.902Z (3 months ago)
• Language: PowerShell
• Size: 17.6 KB
• Stars: 61
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - mdgrs-mei/FancyClearHost - Clears your PowerShell host in a fancy way. (PowerShell)

README

        


# FancyClearHost

[![GitHub license](https://img.shields.io/github/license/mdgrs-mei/FancyClearHost)](https://github.com/mdgrs-mei/FancyClearHost/blob/main/LICENSE)

[![PowerShell Gallery](https://img.shields.io/powershellgallery/p/FancyClearHost)](https://www.powershellgallery.com/packages/FancyClearHost)

[![PowerShell Gallery](https://img.shields.io/powershellgallery/dt/FancyClearHost)](https://www.powershellgallery.com/packages/FancyClearHost)

[![Pester Test](https://github.com/mdgrs-mei/FancyClearHost/actions/workflows/pester-test.yml/badge.svg)](https://github.com/mdgrs-mei/FancyClearHost/actions/workflows/pester-test.yml)

Clears your PowerShell host in a fancy way.

https://user-images.githubusercontent.com/81177095/194883476-fed364b3-a641-4626-8a6a-0743d8b6f5b1.mp4



*FancyClearHost* provides you with the ability to clear the PowerShell host display with some cool text animations. Unlike any other PowerShell modules, it doesn't give you any useful features but you should be able to surprise your colleagues or audiences when you give a demo! 

## Requirements

This module has been tested on:

- Windows 10 and 11 

- Windows PowerShell 5.1 and PowerShell 7.2

## Installation

*FancyClearHost* is available on the PowerShell Gallery. You can install the module with the following command:

```powershell

Install-Module -Name FancyClearHost -Scope CurrentUser

```

## Usage

Just call `Clear-HostFancily` function to play random animations, and type 'q' to quit.

```powershell

Clear-HostFancily

```

You can play a specific animation by adding `Mode` parameter and control the speed by `Speed` paramerter.

```powershell

Clear-HostFancily -Mode Falling -Speed 0.5

```

## Overwriting `cls` alias

By adding the following code to your PowerShell profile, you can overwrite the `cls` alias with a fancy version.

```powershell

function FancyClear

{

    # You can set whatever parameters you want here

    Clear-HostFancily -Mode Falling -Speed 3.0

}

Set-Alias -Name cls FancyClear -Option AllScope

```