Simple Starfield with Python and Pygame

In this tutorial we will create a simple but cool starfield simulation with Python and Pygame. The tutorial will be very brief and accompanied by a self-explanatory small amount of code. See below a video of the simulation in action.

The Idea

To simulate the effect, we start by creating a list of stars positioned randomly across the screen. Then, in the main loop, we continuously move and draw the stars. When a star crosses the bottom screen border, we create a new star at the top of the screen.

The Code

The code is small and clear,  and therefore bears a small amount of explanation. The init() function creates a list of stars positioned randomly across the screen. The move_and_draw_stars() function moves and draws the stars. When moving a star, move_and_draw_stars() checks if the star has crossed the bottom border. If so, it creates a new star at the top of the screen.

import pygame
from random import randrange

MAX_STARS  = 250

def init_stars(screen):
  """ Create the starfield """
  global stars
  stars = []
  for i in range(MAX_STARS):
    # A star is represented as a list with this format: [X,Y]
    star = [randrange(0,screen.get_width() - 1),
            randrange(0,screen.get_height() - 1)]

def move_and_draw_stars(screen):
  """ Move and draw the stars in the given screen """
  global stars
  for star in stars:
    star[1] += STAR_SPEED
    # If the star hit the bottom border then we reposition
    # it in the top of the screen with a random X coordinate.
    if star[1] >= screen.get_height():
      star[1] = 0
      star[0] = randrange(0,639)


def main():
  # Pygame stuff
  screen = pygame.display.set_mode((640,480))
  pygame.display.set_caption("Starfield Simulation")
  clock = pygame.time.Clock()


  while True:
    # Lock the framerate at 50 FPS

    # Handle events
    for event in pygame.event.get():
      if event.type == pygame.QUIT:


if __name__ == "__main__":

Click here to download the source code.


That’s everything for now. In the next tutorial I will show you how to make a parallax starfield.

To stay updated, make sure you subscribe to this blogfollow us on twitter, or follow us on facebook.

  1. what do you do with the updated python

Leave a Comment

Notify me of followup comments via e-mail. You can also subscribe without commenting.