Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Windows Support #561

Merged
merged 7 commits into from
Oct 3, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 11 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,24 +2,22 @@

[![Build Status](https://travis-ci.org/sukeesh/Jarvis.svg?branch=master)](https://travis-ci.org/sukeesh/Jarvis) [![Join the chat at https://gitter.im/Sukeesh_Jarvis/Lobby](https://badges.gitter.im/Sukeesh_Jarvis/Lobby.svg)](https://gitter.im/Sukeesh_Jarvis/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

A Personal Assistant for Linux and MacOS
A Personal Assistant for Linux, MacOS and Windows

![Jarvis](http://i.imgur.com/xZ8x9ES.jpg)

Jarvis is a simple personal assistant for Linux and MacOS which works on the terminal. He can talk to you if you enable his voice. He can tell you the weather, he can find restaurants and other places near you. He can do some great stuff for you. Stay updated about [new functionalities](NEW_FUNCTIONALITIES.md).
Jarvis is a simple personal assistant for Linux, MacOS and Windows which works on the command line. He can talk to you if you enable his voice. He can tell you the weather, he can find restaurants and other places near you. He can do some great stuff for you.

## Getting Started

In order to start Jarvis just clone the repository and run `./setup.sh`
In order to start Jarvis just clone [this repository](https://github.com/sukeesh/Jarvis.git) and run `./setup.sh`

Run **Jarvis** from anywhere by command `jarvis`

On Mac OS X run `source setup.sh`

On Windows run `setup.bat`

**NOTE: Jarvis is not fully ported to windows yet, and has only basic functionality. Jarvis's output is also a bit messy!**

You can start by typing `help` within the Jarvis command line to check what Jarvis can do for you.


Expand All @@ -29,14 +27,14 @@ You can start by typing `help` within the Jarvis command line to check what Jarv

## Contributing

- PR's are accepted!!
- We follow PEP 8 guidelines. Before making a PR, make sure that your code is according to PEP8 standards.
- PRs are accepted!!
- We follow [PEP 8](https://www.python.org/dev/peps/pep-0008/) guidelines. Before making a PR, make sure that your code is according to PEP 8 standards.
- If you have some ideas for new features and you don't have time to implement them please open an issue with the tag new_feature
- Please don't forget to comment (document) your code



### Quickstart: Create a new feature (plugin)
### QuickStart: Create a new feature (plugin)

Create new file custom/hello_world.py

Expand Down Expand Up @@ -68,7 +66,7 @@ jarvis is cool

### Creating a test

Creating a test is optionally but never a bad idea ;).
Creating a test is optional but never a bad idea ;).

[Click here](doc/TESTING.md) to learn more about testing.

Expand All @@ -81,9 +79,9 @@ Creating a test is optionally but never a bad idea ;).
## Optional Dependencies

- Any pyttsx3 text-to-speech engine (``sapi5, nsss or espeak``) for Jarvis to talk out loud (e.g. Ubuntu do ``sudo apt install espeak``)
- Portaudio + python devel packages for voice control
- ``notify-send`` on Linux if you want to recive *nice* and deskotp-notification instead of *ugly* popup windows (e.g. Ubuntu do ``sudo apt install libnotify-bin``)
- ``ffmpeg`` if you want ``music`` to download songs as .mp3 instead .webm
- Portaudio + python-devel packages for voice control
- ``notify-send`` on Linux if you want to receive *nice* and desktop-notification instead of *ugly* pop up windows (e.g. Ubuntu do ``sudo apt install libnotify-bin``)
- ``ffmpeg`` if you want ``music`` to download songs as .mp3 instead of .webm

## Docker

Expand All @@ -98,9 +96,8 @@ Run with docker (docker needs to be installed and running):

**sukeesh**

See also the list of [contributors](https://github.com/sukeesh/Jarvis/graphs/contributors) who participated in this project.
See also the list of [contributors](https://github.com/sukeesh/Jarvis/graphs/contributors) who have participated in this project.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details

2 changes: 1 addition & 1 deletion jarviscli/CmdInterpreter.py
Original file line number Diff line number Diff line change
Expand Up @@ -349,7 +349,7 @@ def do_status(self, s):
print_say(
"{:<20}: {}".format(
disabled,
"OR ".join(reason)),
" OR ".join(reason)),
self)

def help_status(self):
Expand Down
2 changes: 1 addition & 1 deletion jarviscli/PluginManager.py
Original file line number Diff line number Diff line change
Expand Up @@ -220,7 +220,7 @@ def _plugin_get_requirements(self, requirements_iter):
if key in plugin_requirements:
plugin_requirements[key].extend(values)
else:
warning("{}={}: No supportet requirement".format(key, values))
warning("{}={}: No supported requirement".format(key, values))

return plugin_requirements

Expand Down
25 changes: 23 additions & 2 deletions jarviscli/plugins/battery.py
Original file line number Diff line number Diff line change
@@ -1,12 +1,33 @@
import subprocess
from plugin import plugin, require, LINUX
from plugin import plugin, require, LINUX, WINDOWS

VALID_OPTIONS = ['status', 'vendor', 'energy', 'technology', 'remaining']


@require(platform=WINDOWS)
@plugin('battery')
def battery_WIN32(jarvis, s):
"""
Provides basic info about battery fo win32
"""
# https://stackoverflow.com/a/41988506/6771356
import psutil

def secs2hours(secs):
mm, ss = divmod(secs, 60)
hh, mm = divmod(mm, 60)
return "%d:%02d:%02d" % (hh, mm, ss)

batt = psutil.sensors_battery()
if batt.power_plugged:
jarvis.say("Battery is charging: %s%%" % batt.percent)
else:
jarvis.say("charge = %s%%, time left = %s" % (batt.percent, secs2hours(batt.secsleft)))


@require(platform=LINUX, native='upower')
@plugin('battery')
def battery(jarvis, s):
def battery_LINUX(jarvis, s):
"""
Provides battery status like battery percentage
and if the battery is charging or not
Expand Down
6 changes: 2 additions & 4 deletions jarviscli/plugins/clock.py
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@ def clock(jarvis, s):
jarvis.say(ctime(), Fore.BLUE)


@require(native='termdown')
@plugin('stopwatch')
def stopwatch(jarvis, s):
"""
Expand All @@ -21,10 +20,9 @@ def stopwatch(jarvis, s):
SPACE Pause
Q Quit
"""
system("termdown")
system("python -m termdown")


@require(native="termdown")
@plugin('timer')
def timer(jarvis, s):
"""
Expand All @@ -43,5 +41,5 @@ def timer(jarvis, s):
if k[0] == '':
jarvis.say("Please specify duration")
return
timer_cmd = "termdown " + k[0]
timer_cmd = "python -m termdown " + k[0]
system(timer_cmd)
15 changes: 14 additions & 1 deletion jarviscli/plugins/ip.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
from colorama import Fore

from utilities.GeneralUtilities import executable_exists
from plugin import plugin, require, UNIX
from plugin import plugin, require, UNIX, WINDOWS


@require(platform=UNIX)
Expand Down Expand Up @@ -36,3 +36,16 @@ def _get_public_ip(self, jarvis):
system(self._public_ip_v4)
jarvis.say("Public ip v6 address :", Fore.BLUE)
system(self._public_ip_v6)


@require(platform=WINDOWS)
@plugin('ip')
def ip_WIN32(jarvis, s):
"""
Returns information about IP for windows
"""
import socket

hostname = socket.gethostname()
IP = socket.gethostbyname(hostname)
jarvis.say("IP address: " + str(IP))
80 changes: 40 additions & 40 deletions jarviscli/plugins/shutdown.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

@require(platform=LINUX)
@plugin('shutdown')
def shutdown(jarvis, s):
def shutdown_LINUX(jarvis, s):
"""
Shutdown the system
Uses:
Expand All @@ -23,7 +23,7 @@ def shutdown(jarvis, s):

@require(platform=MACOS)
@plugin('shutdown')
def shutdown(jarvis, s):
def shutdown_MACOS(jarvis, s):
"""
Shutdown the system
Uses:
Expand All @@ -42,7 +42,7 @@ def shutdown(jarvis, s):

@require(platform=WINDOWS)
@plugin('shutdown')
def shutdown(jarvis, s):
def shutdown_WIN32(jarvis, s):
"""
Shutdown the system
Uses:
Expand All @@ -61,7 +61,7 @@ def shutdown(jarvis, s):

@require(platform=LINUX)
@plugin('reboot')
def reboot(jarvis, s):
def reboot_LINUX(jarvis, s):
"""Reboot the system"""
if s == '':
s = jarvis.input('In how many minutes?: ')
Expand All @@ -71,77 +71,77 @@ def reboot(jarvis, s):

@require(platform=MACOS)
@plugin('reboot')
def reboot(jarvis, s):
def reboot_MACOS(jarvis, s):
"""Reboot the system"""
string = 'sudo shutdown -r now'
os.system(string)


@require(platform=WINDOWS)
@plugin('reboot')
def reboot(jarvis, s):
def reboot_WIN32(jarvis, s):
"""Reboot the system"""
if s == '':
s = jarvis.input('In how many seconds?: ')
string = 'shutdown /r /t ' + str(s)
os.system(string)


@require(native="systemctl", platform=LINUX)
@plugin('hibernate')
def hibernate_LINUX(jarvis, s):
"""
Hibernate - also known as "Suspend to Disk"

Saves everything running to disk and performs shutdown.
Next reboot computer will restore everything - including
Programs and open files like the shutdown never happened.
"""
os.system('sudo systemctl hibernate')


@require(platform=WINDOWS)
@plugin('hibernate')
def reboot(jarvis, s):
def hibernate_WIN32(jarvis, s):
"""Hibernates the system"""
string = 'shutdown /h'
os.system(string)


@require(platform=WINDOWS)
@plugin('log off')
def reboot(jarvis, s):
"""Log off the system"""
string = 'shutdown /l'
os.system(string)
@require(native="systemctl", platform=LINUX)
@plugin('hybridsleep')
def hybridsleep_LINUX(jarvis, s):
"""
Hybrid sleep.
Will quickly wake up but also survive power cut.
Performs both suspend AND hibernate.
Will quickly wake up but also survive power cut.
"""
os.system("sudo systemctl hybrid-sleep")


@require(platform=WINDOWS)
@plugin('hybridsleep')
def reboot(jarvis, s):
def hybridsleep_WIN32(jarvis, s):
"""Performs shutdown and prepares forfast startup"""
string = 'shutdown /hybrid'
os.system(string)


@require(platform=WINDOWS)
@plugin('log off')
def log_off_WIN32(jarvis, s):
"""Log off the system"""
string = 'shutdown /l'
os.system(string)


@require(native="systemctl", platform=LINUX)
@plugin('suspend')
def suspend(jarvis, s):
def suspend_LINUX(jarvis, s):
"""
Suspend (to RAM) - also known as Stand By or Sleep mode.

Operate PC on a minimum to save power but quickly wake up.
"""
os.system('sudo systemctl suspend')


@require(native="systemctl", platform=LINUX)
@plugin('hibernate')
def hibernate(jarvis, s):
"""
Hibernate - also known as "Suspend to Disk"

Saves everything running to disk and performs shutdown.
Next reboot computer will restore everything - including
Programs and open files like the shutdown never happened.
"""
os.system('sudo systemctl hibernate')


@require(native="systemctl", platform=LINUX)
@plugin('hybridsleep')
def hybridsleep(jarvis, s):
"""
Hybrid sleep.
Will quickly wake up but also survive power cut.
Performs both suspend AND hibernate.
Will quickly wake up but also survive power cut.
"""
os.system("sudo systemctl hybrid-sleep")
19 changes: 16 additions & 3 deletions jarviscli/plugins/systemOptions.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
from platform import architecture, dist, release, mac_ver
from platform import system as sys
from colorama import Fore, Style

import psutil
from plugin import LINUX, MACOS, WINDOWS, PYTHON2, PYTHON3, plugin, require


Expand Down Expand Up @@ -78,12 +78,25 @@ def systeminfo_win(jarvis, s):
os.system("systeminfo")


@require(native="free")
@plugin("check ram")
def check_ram(jarvis, s):
"""
checks your system's RAM stats.
-- Examples:
check ram
"""
os.system("free -lm")
mem = psutil.virtual_memory()

def format(size):
mb, _ = divmod(size, 1024 * 1024)
gb, mb = divmod(mb, 1024)
return "%s GB %s MB" % (gb, mb)
jarvis.say("Total RAM: %s" % (format(mem.total)), Fore.BLUE)
if mem.percent > 80:
color = Fore.RED
elif mem.percent > 60:
color = Fore.YELLOW
else:
color = Fore.GREEN
jarvis.say("Available RAM: %s" % (format(mem.available)), color)
jarvis.say("RAM used: %s%%" % (mem.percent), color)
1 change: 1 addition & 0 deletions requirements.txt
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ mock
nltk
pick
pluginmanager
psutil
pycricbuzz
pydoc-markdown
pync==1.6.1; sys_platform == 'darwin'
Expand Down