Home » Support


If you need assistance troubleshoothing Hypnos, please leave a comment beneath.

AppleScripts for Hypnos 5.2.1 or later

To shut down or restart your Macintosh with Hypnos, please download the shutdown and restart AppleScripts here and put them into the following directory: “~/Library/Application Scripts/com.GuguSoft.Berceuse”. This directory is created automatically when you launch Hypnos 5.2.1 or later for the first time. Included is an Alias that points to this folder. Drop the two AppleScripts on it and you are done.
Or you can type on your own the following commands in the AppleScript-Editor (Resides in the Utilities folder):

To Shut Down:
tell application "Finder" to shut down

To Restart:
tell application "Finder" to restart

These are the same commands as in the downloadable AppleScripts (Additionally, the downloadable AppleScripts include a command to pause iTunes). Save these two scripts and put them in the above mentioned folder.

Hash Mismatch Error when Updating
If you are updating from an older version with a different name than “Hypnos”, a hash mismatch error may occur. To download the newest version successfully, please delete beforehand all old versions.

Listen to the current album only (Does not work anymore in Hypnos 5.2, because of App Sandboxing)

In iTunes you can display your tracks as an album list, grid or cover flow. If you have iTunes in one of this view modes and you check the checkbox “Wait for playlist to finish” in the Hypnos interface, Hypnos will be asking, if you want to listen only to the current album before it takes the chosen action.
All what you need to get it work is to enable the support for assistive devices in the system preference panel “Universal Access”. And the system language of your Mac has to be set to a language that is supported by Hypnos.


35 Responses to “Support”

  1. David says:

    I’m using the most current version of Hypnos, with the Scripts placed properly, and with my desktop hibernation mode at 0. However, the app never successfully shuts down my computer. Instead, it puts it to sleep and kicks the fan on high. Stays like this all night. The app doesn’t seem to connect very well nor help at all. I’m running Mavericks on a late 2012 iMac. Do screen savers interrupt the process? That’s the only thing I can think of, though I should hope not. Any guidance? I loved iTunesShut back in the day.

    • admin says:

      Hi David

      Please check your Emails to find out how you could possibly solve the problem.

      Best, Ludwig

    • admin says:

      If you encounter similar problems as David with Hypnos, the problem in his case was that the AppleScripts were in the right directory, but inside the folder that came with the download. So, please make sure that you only copy the AppleScript-files into the before mentioned directory. To do that you can use the Alias that comes with the AppleScript-download: Drop the two AppleScript-files simply onto the Alias.
      I hope that this will help other users, too.

  2. Mike M says:

    I’ve downloaded version 5.2.5 for hypnos for mavericks & it will not shut down my computer. What needs to be done? Thank you.

  3. Terry says:

    When will the 10.9 version come online? The current v5.2.4 reacts very slowly and sometime not at all now.

  4. david says:

    I have OSX Lion (10.7.x)… i’d been able to run some version of Hypnos on Lion. Then, I had to replace my hard drive and apple reloaded a fresh copy of OSX Lion. I ran through all the updates, then, I restored from backup. Now, when I tried installing Hypnos i get a warning that I need Mountain Lion 10.8. Where can I get a version of Hypnos that ran on 10.7?

    • admin says:

      Hi David

      I sent you an old version of Hypnos. If this does not work, you can try to look for an older version of Hypnos in your Backup. Try to install a version before July 2012 (In July 2012 Mountain Lion was released).

      Ludwig from GuguSoft

  5. Rob says:

    Sorry if you have answered this previously, but I recently had to replace my hard drive and reacquire apps and the like. I used to run Itunesshut and loved it. I run 10.6.8 Snow Leopard and now that the app is Hypnos, it doesn’t support my OS. IS there anyway to get a copy that would? Or at least a copy of the old Itunesshut?

  6. Kirk says:

    I have Hypnos 5.2.2 and OS 10.8.2 with all updates running on a MBP. The “quit” function was working before the most recent Hypnos update. In the morning, I press space bar and the Hypnos dialogue is still on screen with a “-xx” in the time field.

    • admin says:

      Hi Kirk,

      What do you mean exactly with “quit” function? Do you mean the “Quit iTunes” function or the self-quit function of Hypnos?


  7. Donald Horton says:

    Here is a copy/paste of what I did to Hypnos 5.2.1:

    Dons-Mac:~ don$ pmset -g | grep hibernatemode
    hibernatemode 0
    Dons-Mac:~ don$

    I hope this is the clue you wanted. Thanks, Don

    • admin says:

      Yes, that could be the problem, because normally all Macs after 2005 are using hibernatemode 3. On http://www.macworld.com/article/1053471/sleepmode.html You will find more information about the different hibernation modes.
      You can try it out by using Terminal and the following command:

      sudo pmset -a hibernatemode 3

      Please restart your Mac and make a test with Hypnos. Let me know, if it works now as it should!
      I assume that you have already installed the necessary AppleScripts to shut down your iMac. If not, you can download it here

      • Donald Horton says:

        I was harshly warned about “Improper use of the sudo command” and had to enter my password and re-enter the command. Restarted and tested…
        It worked like peanut butter and jelly!
        Thanks for your persistence, Don

  8. Donald Horton says:

    Since I updated to Mt Lion, the shutdown function no longer works correctly. It puts my iMac (3.4GHz Q-Core Intel Core i7) into an odd zombie state. The next morning when I press a key to see if it’s just asleep, it opens a white screen with the pinwheel which spins about 15 times and then shuts down. A restart shows iTunes with Hypnos (oddly set at half volume). I don’t see any other similar complaints posted by users; is this my problem?
    I use this program every night and love it. Are you aware of this bug?
    Thanks, Don

    • admin says:

      Hi Don,

      The white screen with a spinning wheel is shown when a special hibernation mode is activated. You can check the hibernation mode by opening Terminal and typing the following commands:

      pmset -g | grep hibernatemode

      If the result is different than 3, you use not the default hibernation mode and that could cause this odd behavior. Please report back, which hibernation mode your mac is set at.
      Which version of Hypnos do you use?

  9. thunderflash says:


    I don’t have the folder
    ~/Library/Application Scripts/com.GuguSoft.Berceuse
    Not even Applications Scripts (only Applications Support)
    should I create this folder?

  10. Kirk says:

    Love the app! Can you give more specific instructions on how to put the v5.2.1 scripts in the appropriate directory? Using “Go to Folder” with Finder did not show com.GuguSoft.Berceuse.

    • admin says:

      Hi Kirk,

      In Finder go to the “Go to…” menu and press and hold the alt-key. The folder Library should show up when you press the alt-key. Choose the folder “Library” and then “Application Scripts” then you should see the folder “com.GuguSoft.Berceuse”. Put the two AppleScripts into this folder and you are good to go.
      When you use “Go to folder…” it should also work. Use “~/Library/Application Scripts/”, click on the Open-Button and then choose the “com.GuguSoft.Berceuse” folder. If that folder is not there, you have to launch Hypnos first.

  11. Philip says:

    I’m looking for a way to quit iTunes automatically whenever my Mac goes to sleep. I use Jettison to eject my external hard drive before sleep, but it won’t dismount if iTunes happens to be open. Was wondering if Hypnos could be used to quit iTunes whenever my Mac is going into sleep mode?

    • admin says:

      Hi Philipp

      Thanks for your comment. Hypnos puts the Mac to sleep after a predetermined number of tracks were played in iTunes. You can use Hypnos as timer, too.
      Unfortunately, Hypnos does not react on system events, such as going into sleep mode.
      But, you can use Hypnos to quit iTunes automatically after listening to e. g. 4 tracks and then put your Mac to sleep.

  12. Jason says:

    Hi ~,

    After the update, when I choose the follow setting – sleep in XX mins, Hypnos will make a “bip” sound every minute. It didn’t make that noise before. Please help me fix that !

    Thanks & Best regards,

    • admin says:

      Hi Jason,

      You can lower the “Alert volume” for “Sound Effects” in the “Sound” system preferences panel until the new version of Hypnos is out, which will fix this annoying bug. Stay tuned!

  13. Gery says:

    Actually it is not possible to choose “iTunes Pause” for more than one song. In “iTunes Shut” I select “iTunes Pause after 1 Song” once and Itunes stopped after each song. Hypnos can´t do this. You have to press “start” after each time, hypnos paused iTunes.
    Excuse my bad English
    Best regards

  14. James Opie says:

    newest version doesnt have ‘shutdown’ in the list of things to do, that’s the only reason i got this app in the first place, why is it gone, and is it possible to roll back to a previous version?

    • admin says:

      Hi, this update was not only a bug-fix update (New feature: Observe DVD-Player) and as such, Apple requires that app sandboxing is implemented. With sandboxing enabled it is not possible to shut down or restart the Mac programmatically with Hypnos.
      If you use Time Machine you can restore the old version from the backup.
      I am sorry for that and I am looking for ways to enable again the “shut down”- and “restart”-functionality.

      Possible Solution: Enable Hibernate mode.

      Set hibernation mode to 1 using the following command in Terminal: sudo pmset -a hibernatemode 1. Enter an admin password and restart your Mac. If you want revert the change, put 3 instead of 1 (for Desktops put 0).

      Now when you put your Mac to sleep with Hypnos, the RAM contents is written to disk, system is totally shut down while “sleeping,” and slower wake up, due to reading the contents of RAM off the hard drive. That means you can unplug your Mac or change the battery without a hassle during hibernate sleep or safe sleep.
      To turn on the Mac again you have to press the power-button. A grayish Desktop appears with a progress bar, your Mac is restoring the state before sleep.

  15. MIke says:

    are you mountain lion compliant?

    • admin says:

      The current version of Hypnos runs without problems on Mountain Lion. However, a new version that makes use of some new features in Mountain Lion is underway.

Leave a Reply

%d bloggers like this: