How to Build a Real‑Time Console Progress Bar and Countdown in C

Background

When maintaining Linux servers you often need to display progress information on the console. The default C printf output is buffered, so the visual effect depends on newline characters, carriage returns, and the buffering strategy.

Newline vs. Carriage Return

\n moves the cursor to the next line and returns to the start of that line. \r returns the cursor to the beginning of the current line without advancing to the next line. In most C programs \n is used because it combines both actions.

Stdout Buffering Strategies

Unbuffered – data is written directly to the device.

Line buffered – the buffer is flushed when a newline is encountered.

Fully buffered – the buffer is flushed only when it becomes full.

The examples below demonstrate how line buffering affects output timing.

Example 1: Print with Newline

#include <stdio.h>
#include <unistd.h>
int main(){
    printf("I am a proc
");
    sleep(3);
    return 0;
}

The message appears immediately because the newline forces a flush, then the program sleeps for three seconds.

Example 2: Print without Newline

#include <stdio.h>
#include <unistd.h>
int main(){
    printf("I am a proc");
    sleep(3);
    return 0;
}

Here the output is delayed until the program ends because the buffer is not flushed.

Using fflush to Force Immediate Output

Calling fflush(stdout) forces the buffer to be written to the screen, enabling real‑time updates.

Countdown Example (single‑digit)

#include <stdio.h>
#include <unistd.h>
int main(){
    int count = 3;
    while(count >= 0){
        printf("%d\r", count--);
        fflush(stdout);
        sleep(1);
    }
    return 0;
}

This prints a decreasing number in place, but without a newline the output stays in the buffer until fflush is called.

Countdown with Two‑Digit Numbers

#include <stdio.h>
#include <unistd.h>
int main(){
    int count = 10;
    while(count >= 0){
        printf("%2d\r", count--); // width 2, right‑aligned
        fflush(stdout);
        sleep(1);
    }
    return 0;
}

Using the format specifier %2d ensures the tens digit is displayed correctly.

Progress Bar Implementation

#include <stdio.h>
#include <string.h>
#include <unistd.h>

void ProcBar(){
    int i = 0;
    char proc[102];
    memset(proc, '\0', sizeof(proc));
    while(i <= 100){
        printf("[%-100s] [%d%%]\r", proc, i);
        fflush(stdout);
        proc[i] = '#';
        usleep(100000); // 0.1 second
        i++;
    }
    printf("
");
}

int main(){
    ProcBar();
    return 0;
}

The function builds a 100‑character bar, updates it each iteration, and forces the screen to refresh with fflush. The final newline moves the cursor to the next line after completion.

Key Takeaways

Use \n for line‑buffered output or call fflush(stdout) when you need immediate display.

Carriage return \r lets you overwrite the current line, enabling countdowns and progress bars.

Format specifiers (e.g., %2d) control field width for multi‑digit numbers.