{"id":26376420,"url":"https://github.com/mik30s/cysboard","last_synced_at":"2025-03-17T03:17:32.350Z","repository":{"id":138300520,"uuid":"77572843","full_name":"mik30s/Cysboard","owner":"mik30s","description":"A lightweight system monitor similar to conky with html and css for themes","archived":false,"fork":false,"pushed_at":"2017-06-07T16:17:51.000Z","size":24092,"stargazers_count":155,"open_issues_count":7,"forks_count":17,"subscribers_count":20,"default_branch":"master","last_synced_at":"2023-10-19T22:09:36.860Z","etag":null,"topics":["conky","cpu","css","eye-candy","html","linux","theme"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mik30s.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-12-29T01:35:15.000Z","updated_at":"2023-10-19T23:59:01.292Z","dependencies_parsed_at":"2023-11-10T12:54:18.949Z","dependency_job_id":null,"html_url":"https://github.com/mik30s/Cysboard","commit_stats":null,"previous_names":["mike168m/cysboard"],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mik30s%2FCysboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mik30s%2FCysboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mik30s%2FCysboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mik30s%2FCysboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mik30s","download_url":"https://codeload.github.com/mik30s/Cysboard/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243965774,"owners_count":20375920,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["conky","cpu","css","eye-candy","html","linux","theme"],"created_at":"2025-03-17T03:17:31.818Z","updated_at":"2025-03-17T03:17:32.344Z","avatar_url":"https://github.com/mik30s.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"Cysboard \n=========\nA lightweight system monitor similar to conky but with html and css for themes\n\n\u003cimg src=\"https://travis-ci.org/mike168m/Cysboard.svg?branch=master\"/\u003e\n\n## Usage\n1. Create a theme file called main.html in ~/.config/cysboard/ (There must be a file name 'main.html').\n2. Add your html code with any of the listed ids below in html tags for device info.\n3. Run cysboard.\n\nIf a 'main.html' file does not exist in the config directory cysboard will start with a default theme.\n\n## Compiling  \nYou must have cmake \u003e= 3.1 and gcc \u003e= 5.4 in order to compile\n\n1. mkdir build\n2. cmake .\n3. make\n\n\n## Examples\n\u003cdiv align=center\u003e\n\u003cimg src=\"https://cloud.githubusercontent.com/assets/3809183/22609448/dd8ce142-ea26-11e6-845d-a6d67f8a1bd1.png\" /\u003e\n\u003cimg src=\"https://cloud.githubusercontent.com/assets/3809183/22609058/38ead604-ea25-11e6-9781-ad25d0be30cb.png\" /\u003e\n\u003cimg src=\"https://cloud.githubusercontent.com/assets/1056963/25584994/b8e532f2-2e98-11e7-84ea-95e760a1acb4.png\" /\u003e\n\u003c/div\u003e\n\nUse ids like the following \n\n```html\n\u003chtml\u003e\n\u003chead\u003e\n    \u003ctitle\u003eCysboard\u003c/title\u003e\n    \u003cmeta name=\"position_x\" content=\"3400\"\u003e\n    \u003cmeta name=\"position_y\" content=\"50\"\u003e\n    \u003cmeta name=\"width\"  content=\"350\"\u003e\n    \u003cmeta name=\"height\" content=\"350\"\u003e\n    \u003cmeta name=\"time\" content=\"1\"\u003e\n    \u003clink rel=stylesheet href=\"path/to/style.css\" /\u003e\n\u003c/head\u003e\n\u003cbody\u003e\n    \u003cdiv\n       \u003c!-- os info --\u003e\n        \u003cdiv class=\"section\" #osinfo\u003e\n            \u003cdiv \u003eSYSTEM\u003c/div\u003e\n            \u003cdiv class=\"section-content-child\"\u003e\n                \u003cp\u003ename:   \u003cspan id=\"os_name\"\u003e\u003c/span\u003e\u003c/p\u003e\n                \u003cp\u003edistro: \u003cspan id=\"os_distro_name\"\u003e\u003c/span\u003e\u003c/p\u003e\n                \u003cp\u003euptime: \u003cspan id=\"os_uptime\"\u003e\u003c/span\u003e\u003c/p\u003e\n            \u003c/div\u003e\n        \u003c/div\u003e\n        \u003c!-- cpu info --\u003e\n        \u003cdiv id=\"cpuinfo\"\u003e\n            \u003cdiv\u003eCPU\u003c/div\u003e\n            \u003cp\u003emodel:  \u003cspan id=\"cpu_name\"\u003e\u003c/span\u003e\u003c/p\u003e\n            \u003cp\u003evendor: \u003cspan id=\"cpu_vendor\"\u003e\u003c/span\u003e\u003c/p\u003e\n            \u003cp\u003earch:   \u003cspan id=\"cpu_arch\"\u003e\u003c/span\u003e\u003c/p\u003e\n            \u003cp\u003eusage:  \u003cspan id=\"cpu_usage\"\u003e\u003c/span\u003e %\u003c/p\u003e\n        \u003c/div\u003e\n        \u003c!-- mem info --\u003e\n        \u003cdiv id=\"meminfo\"\u003e\n            \u003cdiv\u003eRAM\u003c/div\u003e\n            \u003cp\u003efree: \u003cspan id=\"mem_free\"\u003e\u003c/span\u003e KB\u003c/p\u003e\n            \u003cp\u003eused: \u003cspan id=\"mem_used\"\u003e\u003c/span\u003e KB\u003c/p\u003e\n        \u003c/div\u003e\n        \u003cdiv\u003e\n            \u003cp\u003eProgram 1 Output: \u003cspan id=\"exec_1\" cmd=\"path/to/program\"\u003e\u003c/span\u003e\u003c/p\u003e\n            \u003cp\u003eProgram 2 Output: \u003cspan id=\"exec_2\" cmd=\"path/to/program\"\u003e\u003c/span\u003e\u003c/p\u003e\t    \t\n        \u003c/div\u003e\n        \u003c!-- album art and other stuff --\u003e\n        \u003c!-- you can change the img src tag with shell scripts like this --\u003e\n        \u003cdiv\u003e\n            \u003cimg class=\"album-pic\" id=\"exec_3\" cmd=\"/home/melchor9000/.config/cysboard/dbus.sh 4\"\u003e\n        \u003c/div\u003e\n    \u003c/div\u003e\n\u003c/body\u003e\n\u003c/html\u003e\n```\nPlease see sources/resources/default.html for a working theme. \n\n## IDs\nA list of currently supported information from sources. Add any of\nthem as an *id* attribute for a tag in your theme file.\n\nID             | Info\n-------------- | -----------------\ncpu_name       | The CPU's name                                 \ncpu_usage      | The total usage of the CPU in percentages      \ncpu_arch       | The CPU's architecture                         \ncpu_vendor     | The CPU vendor eg. Intel, AMD                  \ncpu_num_cores  | The number of physical cores                \nmem_free       | The amount of free memory in KB, MB or GB                \nmem_used       | The amount of used memory in KB, MB or GB                \nmem_swap_total | The amount of swap memory in KB, MB or GB                \nmem_total      | The total amount of physical memory available\nos_name        | The name of the OS        \nos_distro_name | The distribution name (*Linux only*)       \nos_uptime      | The total amount of time since last boot\nos_num_procs    | The number of running processes\nexec_#         | Execute a program and display its output eg. *exec_0, exec_1* etc.\ncpu_usage_#    | Get a cpu core's usage percentage eg. *cpu_usage_0, cpu_usage_1* etc.\n\nSome IDs require attributes and can be used like this\n\n```html\n\u003cp\u003eFree RAM: \u003cspan id=\"mem_free\" mul=\"MB\"\u003e\u003c/span\u003e\u003c/p\u003e\n```\n\nAtrribute       | Description                       | Applicable ID(s)\n----------------| --------------------------------- | ---------------------------------------------\nmul             | Display value in MB, KB or GB     | mem_free, mem_used, mem_swap_total, mem_total\ncmd             | Path of program to execute        | exec_#\n\n## Project structure\nThe source code for the project is located in the source directory.\nThe header file `cysboard.h` contains the main update function for the program. \nObjects for information from or about the cpu, os, memory and others are initialized in this class. \nAll the other files house classes for gathering information from various sources. For example `cpuinfo_linux.cpp` has functions for gathering cpu info on a system. The header file `util.h` holds functions for common and repetitive tasks. \n\n## Known Issues\n1. Program crashes sometimes when editing themes.\n\n## Todo\n1. GPU, Disk and Network information.\n2. Add graph and bar controls like conky. \n3. Run commands from theme file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmik30s%2Fcysboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmik30s%2Fcysboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmik30s%2Fcysboard/lists"}