Skip to content

The Wallpaper Downloader is a Django web application that allows users to download random desktop or mobile wallpaper from Unsplash.

Notifications You must be signed in to change notification settings

chukhraiartur/wallpaper-downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Wallpaper Downloader

The Wallpaper Downloader is a Django web application that allows users to download random wallpapers from Unsplash. This application utilizes the power of Celery for task management and Redis as a message broker to efficiently generate and download wallpapers. Users have the flexibility to choose between desktop and mobile wallpapers according to their preferences.

Demo

wallpaper-downloader-demo

Getting Started

Follow these steps to set up the project and run it locally:

Prerequisites

Obtaining an Unsplash API Key

  1. Go to the Unsplash Developer website.
  2. Create an account or log in if you already have one.
  3. Once logged in, go to the Applications page.
  4. Click on the "New Application" button to create a new application.
  5. After creating the application, you will see your Access Key. Copy it; you'll need it later.

Setting Up Your Environment

  1. Clone this repository to your local machine:
git clone git@github.com:chukhraiartur/wallpaper-downloader.git
  1. Navigate to the project directory:
cd wallpaper-downloader
  1. Create a .env file in the project root directory. You can do this using the following command:
touch .env
  1. Open the .env file with a text editor and add your Unsplash API key to it:
UNSPLASH_ACCESS_KEY=your-access-key-goes-here

Replace your-access-key-goes-here with the Access Key you obtained from Unsplash.

Running the Application

  1. Build and start the Docker containers using Docker Compose:
sudo service docker start
sudo docker-compose up --build
  1. Open your web browser and go to http://127.0.0.1:8000/ to access the Wallpaper Downloader application.

  2. Use the application to select the download type (desktop or mobile) and specify the folder path where you want to save the downloaded wallpapers.

  3. Click the "Download" button to initiate the wallpaper download.

Stopping the Application

To stop the application, press Ctrl + C in the terminal where Docker Compose is running. Then, run the following command to clean up the containers:

sudo docker-compose down

Feedback and Contributions

If you have feedback or would like to contribute to this project, please feel free to create an issue or submit a pull request.

Happy wallpaper downloading!

About

The Wallpaper Downloader is a Django web application that allows users to download random desktop or mobile wallpaper from Unsplash.

Topics

Resources

Stars

Watchers

Forks