Git Product home page Git Product logo

lissandrarodrigues / projeto_liv_mega_hack Goto Github PK

View Code? Open in Web Editor NEW
1.0 2.0 1.0 42.68 MB

Liv é uma aplicação web que tem como objetivo trazer modelos de leitura não-convencionais para crianças e jovens de todo o Brasil, tendo em vista que os modelos atuais estão cada vez mais distantes do que eles têm lido atualmente. Projeto desenvolvido na terceira edição do Mega Hack.

Python 31.35% HTML 61.57% CSS 7.08%
whatsapp livro hackathon audio celular leitura arvore-educacao mega-hack

projeto_liv_mega_hack's Introduction

Liv - Mega Hack 3.0

Meu time e eu escolhemos o desafio da Árvore Educação inserido no Mega Hack .

Nossa solução consiste em uma aplicação web que permite o usuário ler ou ouvir livros pelo aplicativo Whatsapp.

  • Página inicial.

alt text

  • Página do Livro Dom Casmurro de Machado de Assis.

alt text

Descrição

  • Site

No site do Liv, o usuário escolhe o livro que deseja ler, digita o número do celular, a quantidade de capítulos que quer receber por dia, o horário que quer recebê-los e o formato de leitura desejado.

  • Leitura no WhatsApp

O programa faz a leitura de um arquivo txt que contém o livro Dom Casmurro de Machado de Assis (escolhemos este livro para a demonstração). Após a leitura, o programa separa o livro em capítulos e envia esses capítulos pelo WhatsApp no formato de mensagem de texto. Cada uma das mensagens enviadas é um parágrafo do capítulo.

Obs.: O livro utilizado foi encontrado no formato de pdf nesta página do Ministério da Educação e foi convertido para a extensão txt utilizando esta ferramenta online.

  • Audiobook no Whatsapp

O programa acessa o Whatsapp, entra em um grupo específico do livro escolhido e encaminha, ao usuário que solicitou, o áudio.

Obs. 1: O grupo referido acima é feito dentro do aplicativo Whatsapp antes da execução do programa e contém o áudio do livro.

Obs. 2: O áudio utilizado pode ser encontrado nesta página .

Obs. 3: A parte da solução responsável por converter os livros em mensagens de texto e áudios no Whatsapp foi escrita na linguagem Python e usa a biblioteca Selenium como base.

Como funciona?

O usuário entra no site, escolhe o livro que quer ler, opta por áudio ou mensagem de texto, cadastra o número de celular e recebe o livro no formato escolhido em seu celular. Para mais detalhes acesse esse vídeo de demonstração.

Instalação

É preciso ter o Python instalado no seu computador (Python , recomendado baixar a última versão). Para importar algumas funções usadas nesse projeto é preciso fazer a instalação de uma biblioteca:

  • selenium - Forma de instalação: pip install selenium

Obs 01.: É também necessário o uso do ChromeDriver 83.0.4103.39 que pode ser baixado nesta página . Ele deve ser inserido na mesma pasta do projeto, entretanto ele já está inserido neste repositório.

Uso

Após as instalações, para começar usar é preciso clonar esse repositório e seguir alguns parâmetros que serão passados pela linha de comando (terminal):

  • Para receber o livro como mensagem de texto:

    • python enviaMensagemTexto.py -c <Número do Capítulo> -n <Nome do usuário que você enviará o livro (tem que ser exatamente igual ao que está no WhatsApp)>

      Exemplo: python enviaMensagemTexto.py -c 19 -n João

      Obs.: Para demonstração, utilizamos o livro Dom Casmurro, que possui 148 capítulos, por isso, escolha um capítulo inserido no intervalo de 1 a 148.

  • Para receber o livro como audiobook:

    • Para o programa funcionar é necessário que previamente um grupo no Whatsapp seja criado com exatamente o nome "Dom Casmurro - Machado A." e neste grupo deve ser colocado o MP3 que pode ser encontrado aqui.

    • python enviaAudio.py -n <Nome do usuário que você enviará o livro (tem que ser exatamente igual ao que está no WhatsApp)>

      Exemplo: python enviaMensagemTexto.py -n João

Time

projeto_liv_mega_hack's People

Contributors

lissandrarodrigues avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Forkers

rdittmarbr

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.