Code Monkey home page Code Monkey logo

wakeonlan's Introduction

WakeOnLAN

WakeOnLAN is a simple C Utility that allows RISC OS to send magic Wake-on-LAN packets.

In other words you can use this utility to wake up NAS devices, PCs and laptops that support the Wake-on-LAN feature. Each remote device will likely require this feature to be enabled, typically in the BIOS. Remote devices will also need to be connected to the same LAN as your RISC OS device.

Tutorial

A short YouTube tutorial is available demonstrating how to use this utility.

Usage

You can use WakeOnLAN in two different ways:

The command line

As soon as RISC OS Filer has seen the !WakeOnLAN Application you will be able to use it from the command line (both in regular CLI and in a TaskWindow) by typing:

WakeOnLAN -m <mac address> [ -b <broadcast address> ] [ -v ]

The parameter -m allows you to specify the Media Access Code (MAC) address of the device you want to wake up. The syntax is in the usual MAC address form such as 01:02:03:04:05:06 (this parameter is NOT optional).

The parameter -b allows you to specify a broadcast address where to send the Wake-on-LAN (WOL) packet. If you do not specify this parameter the default value is 192.168.0.255 (IPv4). You should use this parameter if your network configuration is different to the default one.

Here is a practical example from the command line:

*WakeOnLAN -m 01:02:03:04:05:06 -b 192.168.100.255

The RISC OS Desktop

If you double-click on the !WakeOnLAN application, it will be loaded as a multi-tasking application on the icon bar. You can click the icon bar icon to open the setup window and input the MAC address of the device to wake up along with the broadcast IP address of your network.

In the UI you can save the IP broadcast address to the !Choices file to eliminate the need to re-type it all the time.

Note: The UI makes use of the RISC OS FrontEnd module, so make sure you have it installed before trying to run !WakeOnLAN in multi-tasking mode.

Obtaining !WakeOnLAN without compiling code

If you are not keen to recompile code on RISC OS using GCC or other compilers you can find a pre-built and ready to install !WakeOnLAN from:

Compile WakeOnLAN from the source

Using git, clone this repository on a Linux box in a directory shared with your RISC OS device and make sure you have GCC (at least 4.7.4 release or higher) installed on your RISC OS system.

Open the Shared folder with !OmniClient and navigate to the directory that contains this README file using the regular RISC OS Filer.

Double click on the file called MkGCC and wait until it is done :)

Feedback

In case of problems

For any issue you may encounter please use the Issues option here on GitHub. Please do not try to contact us directly as all RISC OS Community communication is handled here on GitHub.

Requesting new features

New features are also to be requested via Issues on GitHub. Create a new issue using the New issue button and choose the 'New Requirement' template.

Contributing

We welcome improvements and new ideas, before you submit your changes please have a look at the Contributing Guidelines here

License

WakeOnLAN is distribute under Apache License 2.0 (more details here) Please note there are some restrictions, so read the source code for more details.

Copyright (c) 2021 Paolo Fabio Zaino and contributors

Contributors:

Paolo

wakeonlan's People

Stargazers

 avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

wakeonlan's Issues

Help option doesn't work

Description

The 'Help' option doesn't seem to work

To reproduce

  1. Go to 'WakeOnLAN iconbar icon'
  2. Click Menu button to show Iconbar menu
  3. Choose 'Help'
  4. Observe that nothing happens

Expected behaviour

It is expected that the Help file is displayed

Screenshots

n/a

Traceback

n/a

RISC OS Release

RISC OS 5.28

Loaded Modules

Paste here the list of loaded modules. The get the list open a TaskWindow and type: help modules, then copy and paste here the output.

Platform

[ ] - Acorn Archimedes 3x0/4x0 series (with ARM 3)
[ ] - Acorn A5000
[ ] - Acorn A30x0 or A4000 series (with ARM250)
[ ] - Acorn RiscPC 600 (with ARM 610)
[ ] - Acorn RiscPC 700 (with ARM 710)
[ ] - Acorn RiscPC StrongARM
[ ] - Acorn RiscPC with Kinetic or Castle RiscPC
[ ] - Acorn A7000/A7000+ or Castle A7000+
[ ] - Raspberry Pi1 (model A or B)
[ ] - Raspberry Pi2 (all models)
[x] - Raspberry Pi3 (all models)
[ ] - Raspberry Pi4 (Please specify the amount of RAM in the Other Field at the end of this list)
[ ] - Raspberry Pi400 (Please specify the amount of RAM in the Other field at the end of this list)
[ ] - i.MX6 / Mini.M
[ ] - PineBook / ARMBook
[ ] - PandaBoard
[ ] - WandaBoard or Quadro
[ ] - Titanium board
Other:

Other possible details

Feel free to use this part as a free file where to add info we may have not think of above, thanks.

MAC address is not saved

Background

When choosing 'Save Options' in the UI, the IP Broadcast Addr is saved, but not the Target MAC Addr.

Questions

  • Is this intentional behaviour?
  • Would it not make more sense to also save the MAC address?
  • If this is intended, what is the rationale? (Just trying to understand intended use case)

Ensure that WakeOnLan runs also on RISC OS 4.x and 6.x

Background

WakeOnLan works fine on RISC OS 5 and builds using GCC. Next step is to test and fix (where needed) issues to ensure it runs fine also on RISC OS 4.xx and 6.xx

Do not commit directly in the main branch, instead create your branch or fork, make your changes, test them and then ask for a PR to develop branch.

Multiple PRs are ok :)

Definition of Done

  • Add fixes to compile with older releases of GCC that runs on RISC OS 4.xx and 6.xx
  • Ensure it builds fine on both RISC OS 5 and the older two releases
  • Document you changes

Make a short Youtube video about how to use WakeOnLAN for both Desktop and CLI

Background

In order to help users to have an easy life with !WakeOnLAN tool for RISC OS, make a short Youtube video explaining how to use it in both cases:

  1. From the Desktop
  2. As a command, for example executed by !Alarm or some other form of automation

The video has to be done on a RISC OS powered device (for example Raspberry Pi, RComp Mini.M, Castle Iyonix PC, Pandaboard etc.)

You can publish the video on your own Channel, so this is also an opportunity to drive views to your YouTube channel.

When you're done ask for a PR, where we'll add your Youtube video link to the README.md in the documentation to this repository.

Do not commit directly to the main branch, instead create your own branch or fork, make the video, add the link to the README.md and submit it as a PR in develop branch.

Definition of Done

  • Video is published and reachable
  • Video show how to use the software and it's clear and either mute or with a nice commentary
  • Video is titled: How to use RISC OS !WakeOnLAN
  • Video is short and show ALL the options used on both the WIMP and the CLI

WakeOnLAN video audio volume appears much lower than the average YouTube video audio volume

Background

@mattharris ,
quick thought, today I have compared the audio volume of your video with the average youtube videos audio-volume.
It seems that WakeOnLAN video audio-volume is way lower than the audio-volume of the average youtube video.

Could you please check and, if I am correct, apply some audio compression to increase the base volume of your video? Please compare with general YouTube video.

Why is this a potential problem? Because if indeed the volume of the video is too low compared to the average video audio-volume and advertisements and a user is forced to increase his computer volume, then, when an ad may start or when the video switch for another one we may cause the user to have an heart attack ;)

Thanks.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.