Progress indicators in Bash Scripting

Introduction

Progress indicators show users that a task is running and how much is done. They make waiting less boring and give feedback.

When copying large files and you want to show how much is copied.

When running a script that takes time, like downloading or installing software.

When processing many items in a loop and you want to show progress.

When waiting for a background task to finish and you want to keep the user informed.

Syntax

Bash Scripting

# Simple spinner example
while :; do
  for c in '-' '\\' '|' '/'; do
    printf '\r%c' "$c"
    sleep 0.1
  done
 done

Use \r to return the cursor to the start of the line to overwrite the previous character.

Sleep controls how fast the spinner moves.

Examples

Shows a spinner with the text 'Processing...' updating every 0.2 seconds.

Bash Scripting

# Spinner showing progress
while :; do
  for c in '-' '\\' '|' '/'; do
    printf '\rProcessing... %c' "$c"
    sleep 0.2
  done
 done

Shows a progress bar filling up from 0% to 100% in steps of 5%.

Bash Scripting

# Progress bar example
for i in {1..20}; do
  sleep 0.1
  printf '\r['
  for ((j=0; j<i; j++)); do printf '='; done
  for ((j=i; j<20; j++)); do printf ' '; done
  printf '] %d%%' $((i * 5))
done
printf '\n'

Sample Program

This script shows a spinner next to 'Working...' for 2 seconds, then prints 'Done!'.

Bash Scripting

#!/bin/bash
# Simple spinner while sleeping
spin='-|/\\'
printf 'Working... '
for i in {1..20}; do
  printf '\rWorking... %c' "${spin:i%4:1}"
  sleep 0.1
done
printf '\nDone!\n'

Important Notes

Use \r (carriage return) to overwrite the same line instead of printing new lines.

Make sure to flush output if needed (printf usually does this).

Keep the spinner or progress bar simple to avoid flickering.

Summary

Progress indicators give feedback during long tasks.

Use \r to update the same line in the terminal.

Spinners and progress bars are common types of indicators.

Practice

1. What is the main purpose of using a progress indicator in a bash script?

easy

A. To print all output to a file instead of the screen

B. To speed up the execution of the script

C. To stop the script if an error occurs

D. To show the user that a long-running task is still working

Solution

1. Step 1: Understand what progress indicators do

   Progress indicators provide visual feedback during long tasks to reassure users the script is running.

2. Step 2: Identify the correct purpose

   Among the options, only showing the user the task is still working matches the purpose of progress indicators.

3. Final Answer:

   To show the user that a long-running task is still working -> Option D

4. Quick Check:

   Progress indicator purpose = show task progress [OK]

Hint: Progress indicators show task status, not speed or errors [OK]

Common Mistakes:

• Thinking progress indicators speed up scripts
• Confusing progress indicators with error handling
• Assuming progress indicators redirect output

2. Which of the following bash code snippets correctly updates the same line to show a spinner?

easy

A. echo -ne "|\r"; sleep 1; echo -ne "/\r"

B. echo "|"; sleep 1; echo "/"

C. echo -n "|"; sleep 1; echo -n "/"

D. echo -e "|\n"; sleep 1; echo -e "/\n"

Solution

1. Step 1: Understand how to update the same line in bash

   Using echo -ne with \r returns the cursor to the start of the line to overwrite it.

2. Step 2: Check each option for correct usage

   echo -ne "|\r"; sleep 1; echo -ne "/\r" uses echo -ne "|\r" and echo -ne "/\r", which updates the same line. Others print new lines or lack -e or -n.

3. Final Answer:

   echo -ne "|\r"; sleep 1; echo -ne "/\r" -> Option A

4. Quick Check:

   Use echo -ne with \r to update line [OK]

Hint: Use echo -ne and \r to overwrite the same line [OK]

Common Mistakes:

• Using echo without -n or -e flags
• Using \n instead of \r to update line
• Printing spinner on new lines instead of same line

3. What will be the output of this bash snippet?

for i in {1..3}; do
  echo -ne "Processing $i...\r"
  sleep 1
done
echo "Done!"

medium

A. Processing 1...
Processing 2...
Processing 3...
Done!

B. Processing 3...
Done!

C. Processing 1...Processing 2...Processing 3...Done!

D. Done!
Processing 3...

Solution

1. Step 1: Understand echo -ne with \r inside the loop

   Each loop iteration prints 'Processing i...' and returns cursor to line start, overwriting previous output.

2. Step 2: Determine final visible output after loop

   Only the last 'Processing 3...' remains visible, then 'Done!' prints on a new line.

3. Final Answer:

   Processing 3... Done! -> Option B

4. Quick Check:

   \r overwrites line, last iteration visible [OK]

Hint: Remember \r returns cursor, overwriting previous line [OK]

Common Mistakes:

• Thinking all lines print separately
• Confusing \r with \n
• Ignoring that echo -ne prevents newline

4. Identify the error in this bash spinner script snippet:

spinner="|/-\\"
while true; do
  for i in $(seq 0 3); do
    echo -ne "${spinner:$i:1}\r"
    sleep 0.2
done
done

medium

A. The script will cause an infinite loop without exit

B. The for loop uses incorrect sequence range

C. The spinner string is missing characters

D. The substring syntax ${spinner:$i:1} is invalid in bash

Solution

1. Step 1: Analyze the loop structure

   The outer while true loop runs forever without any exit condition.

2. Step 2: Check for exit or break statements

   No break or exit is present, so the spinner runs infinitely, which may be unintended.

3. Final Answer:

   The script will cause an infinite loop without exit -> Option A

4. Quick Check:

   while true without break causes infinite loop [OK]

Hint: Check loops for exit conditions to avoid infinite loops [OK]

Common Mistakes:

• Assuming infinite loops are errors always
• Confusing substring syntax with error
• Ignoring that spinner string is correct

5. You want to create a progress bar in bash that fills from 0% to 100% in 10 steps, updating on the same line. Which approach correctly implements this?

hard

A. Use echo without -n or -e flags inside the loop to print progress

B. Print all '#' characters at once, then sleep 10 seconds

C. Use a loop from 1 to 10, print '#' repeated i times with echo -ne and \r, then sleep

D. Use multiple echo commands without \r to print progress on new lines

Solution

1. Step 1: Understand progress bar update method

   To update on the same line, use echo -ne with \r to overwrite the line each iteration.

2. Step 2: Implement loop with repeated '#' characters

   Loop from 1 to 10, print '#' repeated i times, then sleep to simulate progress.

3. Final Answer:

   Use a loop from 1 to 10, print '#' repeated i times with echo -ne and \r, then sleep -> Option C

4. Quick Check:

   Loop + echo -ne + \r = progress bar update [OK]

Hint: Use echo -ne with \r and repeated chars in loop [OK]

Common Mistakes:

• Printing progress on new lines instead of same line
• Not using echo -n or -e flags
• Printing all progress at once without updates