/BeepFrequency

A wrapper for the Beep function from the Win32 API.

Primary LanguageC++GNU General Public License v3.0GPL-3.0

Beep Frequency Beep Frequency Logo

Readme Card



About

All files can be found on the Releases page.

Description

This Windows command line tool enables anyone to be able to call the Beep()[2] function from the Win32 API library creating a beep sound in hertz[3] frequency.

Motivation

I wanted a solution for doing pure tone hearing tests[4] in my home. Of course my family and friends would get a second opinion if we found our hearing was failing this test.


Usage

Environment

This is a Windows command line tool for CMD and PowerShell. There are both x86 (32 bit) and x64 (64 bit) versions of the executable.

How To Use

As with any portable program this can be placed anywhere you like on your machine, but more preferably in a directory that is in your %PATH% environment variable so you can run it without a full path (beepfreq for example). I recommend using a dedicated Bin directory, but of course, it's your choice. If your path isn't already in your %PATH% environment then I suggest adding it[1], but if not then you have provide the full path (C:\Path\To\beepfreq.exe for example) when executing the program.

Examples

Get help

PS> beepfreq /?

Beep Frequency  - A wrapper for the Beep function
                  from the Windows API.

beepgreq  [/? | /h | /help] |
          [[/f | /frequency] <HERTZ>]
          [[/d | /duration] <DURATION>]

  HERTZ     Hertz integer value of the beep.
  DURATION  Duration integer value of the beep.

  /?, /h, /help   This help screen.
  /f, /frequency  The beep's frequency in hertz
  /d, /duration   The duration of the beep in
                  milliseconds.

Initiate a beep at 8000Hz for a duration of 2 seconds (2000 milliseconds)

PS> beepfreq /f 8000 /d 2000


Project Information

This project is written in C++.

C++

Source File Quality

This is graded by CodeFactor and is subjective, but helps me to refactor my work.

Name Status
codefactor.io

File MD5 Hashes

All hashes are retrieved at compile/build time.

Current Windows X86 MD5

WINDOWS X86 MD5

Current Windows X64 MD5

WINDOWS X64 MD5

Other Miscellaneous File Information

Description Status
Project Release Date GitHub Release Date
Total downloads for this project GitHub all releases
Complete repository size This Repo Size
Commits in last month GitHub commit activity
Commits in last year GitHub commit activity

Notes

Note 1

Adding a path to the Windows %PATH% environment variable @ DuckDuckGo

Note 2

Windows API Beep Function

Note 3

hertz frequency @ DuckDuckGo

Note 4

My source for pure tone hearing test


Media

Logo

Logo

Help

HELP

Example

EXAMPLE1


Support Me If You Like

If you like any of the projects below and care to donate to my PayPal:

PayPal Donation

Or Buy Me A Coffee if your prefer:

Buy Me A Coffee


License Info

License Excerpt
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.