{"id":24856695,"url":"https://github.com/secondtruth/blstools","last_synced_at":"2025-10-15T01:31:45.442Z","repository":{"id":27002561,"uuid":"30466587","full_name":"secondtruth/blstools","owner":"secondtruth","description":"Monitor the unit status of Buffalo Linkstation LS-WXL and LS-CHL","archived":false,"fork":false,"pushed_at":"2015-03-03T10:33:19.000Z","size":140,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-04T05:55:51.159Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/secondtruth.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-07T19:06:16.000Z","updated_at":"2023-06-24T12:46:03.000Z","dependencies_parsed_at":"2022-08-21T09:00:49.193Z","dependency_job_id":null,"html_url":"https://github.com/secondtruth/blstools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/secondtruth/blstools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secondtruth%2Fblstools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secondtruth%2Fblstools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secondtruth%2Fblstools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secondtruth%2Fblstools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/secondtruth","download_url":"https://codeload.github.com/secondtruth/blstools/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secondtruth%2Fblstools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279032993,"owners_count":26089390,"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","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-01-31T16:45:45.548Z","updated_at":"2025-10-15T01:31:45.193Z","avatar_url":"https://github.com/secondtruth.png","language":"Shell","readme":"blstools\n========\n\nThis is a small set of scripts that control some behaviour of Buffalo LinkStation\nLS-WXL and LS-CHL (and possibly LS-XHL). They are supposed to be installed under\nDebian Lenny/Squeeze, after a debootstrap installation which leaves active the\n\"buffalo kernel extensions\", i.e. the `/proc/buffalo` stuff.\n\nScripts are partly derived from the stock LinkStation software but have been \ntotally rewritten in order not to use the `/usr/sbin/miconapl` utility and to\nrely only on `/proc/buffalo`, which greatly reduces dependencies.\n\nWork is in progress to implement some interesting features such as handling the\n\"function\" button in front/back of the unit.\n\nSome technical documentation is available under `docs/` directory.\n\n\nDisclaimer\n----------\n\nThis is experimental software. I happen to be quite satisfied with it, but I cannot \nguarantee the same for other.\n\nWhatever you do with it you do it at your own risk. Be aware that you may lose data\nor even permanently damage or brick your unit.\n\n\nInstallation\n------------\n\nSupported products:\n\n - Buffalo LinkStation Duo (LS-WXL)\n - Buffalo LinkStation Live III (LS-CHL v2)\n - Buffalo LinkStation Pro (LS-XHL) [not tested]\n\nSoftware prerequisite is a plain Debian Lenny/Squeeze installation. Guides are available at:\n\n - http://buffalo.nas-central.org/wiki/Debian_Squeeze_on_LS-WXL\n - http://buffalo.nas-central.org/wiki/Debian_Lenny_on_LS-WXL\n - http://buffalo.nas-central.org/wiki/Debian_Squeeze_on_LS-CHLv2\n - http://buffalo.nas-central.org/wiki/Debian_Lenny_on_LS-CHLv2\n\nAlso required is the `smartmontools` package in order to be able to get system temperature\nfrom HDD:\n\n\tsudo apt-get install smartmontools\n\nInstalling should be as simple as downloading/unpacking the package directly on the\nLinkStation and then running:\n\n\tsudo ./install.sh\n\n\nFeatures\n--------\n\n### 1. lsmonitor (`/etc/init.d/lsmonitor`)\n\nThis is a daemon that is automatically started when the system boots. You don't need\nto call it directly.\n\nlsmonitor stops the blue led from flashing and provides a reassuring, still blue \nlight. Also, when you move the switch in \"off\" position lsmonitor initiates system \nshutdown (which is nice, isn't it)?\n\nlsmonitor controls the fan speed on system temperature. Since there are\nno system temperature sensors, temperature is read from Hard Disk \ninformation (S.M.A.R.T.), which is managed through smartmontools (thanks \nto archonfx@Buffalo NAS central forums for suggestion). There are three \nthresholds, HDDTEMP0, HDDTEMP1 and HDDTEMP2 (defaults 40, 45 and 50 \nCelsius degrees):\n\n - if T \u003c HDDTEMP0 fan is stopped\n - if HDDTEMP0 \u003c= T \u003c HDDTEMP1 fan runs at slow speed\n - if HDDTEMP1 \u003c= T \u003c HDDTEMP2 fan runs at fast speed\n - if T \u003e= HDDTEMP2 fan runs at full speed\n\nTemperature thresholds can be configured in `/etc/default/lsmonitor`. \n\nlsmonitor checks if one presses the function button in the front of the unit. \nIf so, it runs all the scripts and executables found in `/etc/blstools/func-scripts/`. \nDuring the execution of the scripts the function button is turned into flashing blue.\nThis is useful as a quick access method to special functions, such as a backup \nscript that is run on demand by the user. You can know whether the scripts are \nrunning and when they finish by looking at the blinking light. Note that pressing\nthe function button while the func-scripts are running has no effect.\nNote also that the scripts in `/etc/blstools/func-scripts/` are run as `root` user.\nOutput produced by the scripts is logged to `/var/log/blstools/func-scripts.log`, which\nis rotated by `/etc/logrotate.d/blstools` script.\n\n### 2. usb (`/etc/init.d/usb`)\n\nPowers on and off the USB interface.\n\nWhen you want to connect a USB disk to the LinkStation you should first call\n`/etc/init.d/usb start` and then you will be able to mount the USB drive to the\ndesired location (generally, the device will be `/dev/sdb1`).\n\n\nDevelopment\n-----------\n\nThis is open source software. The original sources are under SVN on SourceForge and\ncan be checked-out at the following URL:\n\n - https://blstools.svn.sourceforge.net/svnroot/blstools/trunk\n\nYou are welcome to contribute. Please write your ideas and suggestions to \nmichele.manzato@gmail.com.\n\n\nContributors\n------------\n\nThanks to the contributors:\n\n - Michele Manzato\n - Guilherme Cardoso\n - Christian Neff (secondtruth)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecondtruth%2Fblstools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsecondtruth%2Fblstools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecondtruth%2Fblstools/lists"}