How to Build a Real-Time Console Progress Bar in C

In routine server maintenance we often need a visual progress indicator; this article shows how to implement such a progress bar in C, covering newline vs carriage return, output buffering strategies, using fflush to force screen updates, and handling multi‑digit countdowns.

1. Carriage Return and Newline

Newline moves to the next line (\n), while carriage return returns to the start of the current line (\r). In C, \n typically means newline plus return to the line start.

2. Buffering

Two code examples illustrate how output buffering affects when text appears on the screen.

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

int main()
{
    printf("I am a proc
"); // contains 

    sleep(3);
    return 0;
}

This prints immediately, then sleeps for 3 seconds.

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

int main()
{
    printf("I am a proc"); // no 

    sleep(3);
    return 0;
}

Here the output is buffered and not shown until the program ends.

The three buffering strategies are:

Unbuffered: data is written directly to the device.

Line buffered: data is flushed when a newline is encountered.

Fully buffered: data is flushed only when the buffer is full.

The first example uses line buffering, so the newline forces a flush.

3. Countdown Program

Printing a number followed by a carriage return can create a countdown effect, but without a newline the output stays in the buffer.

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

int main()
{
    int count = 3;
    while(count >= 0)
    {
        printf("%d\r", count--);
        fflush(stdout);
        sleep(1);
    }
    return 0;
}

Using fflush(stdout) forces each number to appear immediately.

For two‑digit countdowns, the carriage return always returns to the first character, so the second digit does not update unless we format the output width.

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

int main()
{
    int count = 10;
    while(count >= 0)
    {
        printf("%2d\r", count--); // width 2
        fflush(stdout);
        sleep(1);
    }
    return 0;
}

4. Progress Bar Program

#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)
    {
        // left‑align with '-'
        printf("[%-100s] [%d%%]\r", proc, i);
        fflush(stdout);
        proc[i] = '#';
        usleep(100000); // 0.1 second
        i++;
    }
    printf("
");
}

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

This function builds a visual progress bar that updates in place, showing the percentage completed.