Skip to content

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Conky configuration file

These are my Conky configuration files.

Conky

A sleek, minimalist Conky configuration that displays real-time system information and weather data on your desktop. Features live weather forecasts with OpenWeatherMap integration, system resource monitoring (CPU, memory, disk I/O), network statistics, and process tracking—all in a clean, transparent overlay that stays out of your way.

Requirements

  • Conky 1.10 or later (uses Lua-based configuration syntax)
  • Lua 5.1 or later (for Conky 1.10+ compatibility)

Installation

Fetch the configuration files from the GitHub repository:

$ git clone git://github.com/mrmierzejewski/conkyrc.git ~/.conky

Create link:

ln -s ~/.conky/conkyrc ~/.conkyrc

Note: This configuration uses the modern Lua-based syntax (Conky 1.10+). If you're using an older version of Conky, you may need to upgrade or use a legacy configuration format.

Enjoy!

Features

  • weather with forecast
  • CPU graph
  • memory graph
  • network graph
  • processes

Weather Configuration

This configuration uses OpenWeatherMap API (Yahoo Weather API was retired in 2019).

To configure weather:

  1. Get a free API key from https://openweathermap.org/api

    • Sign up for a free account
    • Navigate to API keys section
    • Copy your API key
  2. Edit conkyrc and replace:

    • YOUR_API_KEY with your OpenWeatherMap API key
    • YOUR_LOCATION with your location (e.g., "London,UK", "New York,US", or coordinates like "40.7128,-74.0060")
  3. Location format options:

    • City name: "London"
    • City with country: "London,UK"
    • Coordinates: "40.7128,-74.0060"

Troubleshooting

Syntax Errors: If you encounter syntax errors like "syntax error near 'yes'" or "loadstring" errors, ensure you're using Conky 1.10 or later. The configuration uses the modern Lua-based syntax.

Check your Conky version: $ conky --version

For older Conky versions (< 1.10): You'll need to upgrade Conky to use this configuration, or convert it back to the legacy format (not recommended as Yahoo Weather API is no longer available).

Weather not displaying:

  • Verify your OpenWeatherMap API key is correct
  • Check that your location string is properly formatted
  • Ensure you have internet connectivity
  • Check the cached weather files: ~/.cache/weather-current.json and ~/.cache/weather-forecast.json

About

A sleek, minimalist Conky configuration that displays real-time system information and weather data. Features live weather forecasts, system resource monitoring (CPU, memory, disk I/O), network statistics, and process tracking - all in a clean, transparent overlay that stays out of your way.

Resources

Stars

152 stars

Watchers

9 watching

Forks

Releases

Packages

Contributors